Community
Participate
Working Groups
Build Identifier: 20100617-1415 In software development the technical documenation is always something that developers don't like very much. To ease the documentation process, it would be maybe a idea to integrate wiki pages to tasks. That mean: In the task-editor I have the possibility to connect a wiki page(Confluence, MediaWiki, etc.) to the task. In the task I have a section/tab where I can edit the wiki text and submit it again back to the configured wiki page. I think this could be useful, what do you think? Reproducible: Always
This could maybe be placed under org.eclipse.mylyn.docs
We generally use tasks to document changes and keep other technical documentation directly in the source code which is referenced by the context. Commercial Mylyn extensions also allow tracking of web pages such as Wiki documents in the context which we to edit user documentation. What kind of documentation where you thinking of?
I think of a higher internal technical documentation or a user documentation for the customer. That's true that we also have technical documentation at the source level, but we also have technical documentation which includes severals UML diagramms(sequence, class, etc.) and so on which is better documented in a wiki or other format. An idea would also be to have such documentation also versionized in the VCS in a Latex or wiki format and then we could attach these files to the task context too. The commercial Mylyn extension sounds great too, where can I find this? So a "wiki-page integration" for the Mylyn task editor interface is maybe a bit too much...
You can find a list of extensions on the Wiki, e.g.: http://wiki.eclipse.org/Mylyn/Extensions#Office_Documents_and_Web_Page_.28by_Tasktop.29 It sound like the technical documentation is a resource in your case and should hence be tracked through the context. That works out of the box if the documentation is stored in the workspace but otherwise I would recommend taking a look at the extensions above.
