These are notes from the first discussion in the Wiki-based Software Documentation.
The goal of this discussion was to enumerate problems, possible improvements, good qualities and "wishes" for wikis to document software.
As a start, we have prepared
a list of software engineering topics where wiki-based software documentation can be helpful, ideally. The list was taken from
http://www.swebok.org .
Pros
- search & retrieval
- auto-magic linking
- separation of contents structure and presentation
Areas for improvement
- higher levels of abstraction for contents
(to be completed...)