Share and persist knowledge while using Eclipse

What will encourage devel开发者_开发问答opers working on application maintenance and development using Eclipse to contribute knowledge gained on application, while fixing an issue or carrying out new development. For example Some test data/scenario which is relevant to a java file or some very potent information about the program. This knowledge can be persisted in some way, but the key here is would any developer like to share the knowledge imbibed while working on solving issues or creating new files beyond adding comments.

You could try and add a wiki editor within the developpers's eclipse.
See EclipseWiki

Or you can add a special brand of wiki, like the FitNesse one (see its one minute description).
See BrandXI

alt text http://www.bandxi.com/fitnesse/images/features-new-wizard1.gif

It will capture what the software should do and what it does.

I would agree with the suggestion to use a project wiki stored as plain text files in the Eclipse project. I find that to be a very useful way of writing documentation. However, I would suggest using Mylyn WikiText, which is already installed if you have an Eclipse 3.5 with Mylyn. If not, it can be installed via the Galileo update site. It offers a great editor, exports to various formats (HTML, PDF, etc.) and supports many different wiki markup flavours (Textile, Confluence, MediaWiki, and Trac).