[Lazarus] Project management

Hans-Peter Diettrich DrDiettrich1 at aol.com
Tue Feb 28 22:39:52 CET 2012


Juha Manninen schrieb:

> Improving the documentation is now a "hot topic". I think more people 
> should get write access to the doc directory in the repository, if only 
> there are people willing to take the effort.

IMO this is not a good idea, for several reasons:

I already removed so much crap from the docs, which may creap in again 
with uncontrolled access.

In contrast to source code, there is no compiler that could verify the 
correctness of the documentation. Most entries deserve notes like 
"deserves citations" in wikipedia, and background information proofing 
the descriptions as correct. The new <notes> could be used to supply 
such information, similar to the "discussion" page in wikipedia.

The XML files are very sensitive to reformatting or moving parts around. 
Reformatting done e.g. by LazDE can result in an commit of the entire 
file, hiding the essential differences.

DoDi





More information about the Lazarus mailing list