My company is using Trac for its project management. We use the Wiki portion for all our documentation, but we have run into some issues with it:
- A "comment block" markup similar to phpBB's [quote=username].../quote tags, to allow a comment block to be added and tagged with the name of the person who wrote the comment. This helps separate comments and side notes from the main flow of a document. (comment blocks could be floated to the side or even just enclosed in a border so they are visually separated and easier to read around)
- A "notes" markup. This one's somewhat harder to explain, but basically it should be easy to add small inline notes into a document that would usually be formatted as smaller, italicized text. This is useful for side notes and comments by the actual document author.
- TODO tags. (and possibly FIXME, and other similar tags) This is a useful way of keeping track of unfinished documents and documents that need to be fixed. It would also be nice to be able to generate a report showing all existing TODO tags in the wiki.
I've heard that some of these may be added to the Trac trunk in the near future, which would be great. If not, it would be nice to see these in a hack of some sort.