From: Atanas I. <ata...@gm...> - 2005-12-29 13:03:40
|
Hi All, I'm responsible for a small team, which works on another open source projec= t (http://sourceforge.net/projects/cybercore). However, as we all know, the whole effort is of a little value without a proper documentation... When it comes to documentation, NDoc is the tool which will play the centra= l role (no surprises here). The problem is that currently NDoc can be used fo= r only what I call "API refernce", which is far away from what I consider to be the necessary minimum. So I've assigned to one of the developers the task to "upgrade" the msdn documenter in such a way, which will permit us to create custom topic trees in the TOC - they will lead to not-directly-code-related info (but with possible liks to the API reference). Here is the place to say, that she started to show some quite serious pregress... Regarding all this, I would like to ask 2 questions: - Is there something like this already realized? I do not like the possibility to come out with a re-invented wheel at the end... - Because this "enchancement" seems like a very serious candidate for contribution, is there such planned feature (i.e. - is there a need for suc= h a contribution)? |