[Lazarus] Project management
DrDiettrich1 at aol.com
Thu Mar 1 16:22:39 CET 2012
Martin Schreiber schrieb:
> I experience the same from time to time in MSEide+MSEgui project. People
> complain missing documentation and write if there were good
> documentation tools (which actually means if I would make them) they and
> other users would write documentation.
Tools are not a replacement for content :-(
> Don't believe such statements, it is not true. The mentioned Lufdoc from
> Lars is such a good tool for user contributed source documentation, it
> exists since a long time. AFAIK there is not a single Lufdoc
> contribution from MSEde+MSEgui users other than Lars.
Searching the *web* returns only a few Lufdoc pages, with almost no
content. This indidicates to me that the tool has never been used for
any purpose, except demonstrating that it is there. MakeSkel can be used
for that job as well.
> The only thing what would happen if you or me would build the perfect
> documentation tool is that they would use that tools in their projects...
> People who are willing to work on documentation are able to work with
> existing possibilities or improve the tools oneself.
But as mentioned above, what result can be expected when writing
documentation is considered the task of *unrelated* people, which have
nothing but undocumented source code as a starting point?
You (and others) seem to believe that there exist people, which are both
able to understand the undocumented code of others, *and* are able to
document it in a reasonable way, *and* find it more fun to write
documentation for others (and for free!), instead of writing their own
code. A very realistic assumption, indeed :-(
More information about the Lazarus