The Nokia Developer Wiki displays comments in-line with the article. This is a great feature because it makes it very easy to ask questions, and because readers get all the comments (bug reports, suggestions for improvement, thanks, and requests) along with the content. I use it regularly to have discussions with authors about how content can be improved.
While I love the commenting, there are a few things to keep in mind:
- The person who wrote the article may have left the community or may not be “watching” the article. Check the article creation date – for older articles it is often best to send a private message the author or to raise the question on the discussion boards.
- Don’t ask questions that are only very “slightly” related to the article, as these distract from the article itself. Ask “off-topic” questions on the discussion boards so that more people can see them: if you think an author might be able to help, send them a private message linking to their article and the discussion board post.
- Make fixes in the article in preference to adding “bug report” comments – if you’re confident of your fix! You can always private-message the author for a review.
We’ve just added a Recently Commented Articles panel on the Wiki Home page, listing the articles with new comments and the most recent poster’s user name.
Use it to find out what articles people are discussing – maybe you can offer some advice or ideas.