On 08.04.2016 19:10, Jürgen Hestermann wrote:
Am 2016-04-08 um 18:04 schrieb Ondrej Pokorny:
On 08.04.2016 18:56, Jürgen Hestermann wrote:
When asking for documentation here I am often answered: Check the code.
Yep. Correct. If you think the documentation is bad, check the code
and write it. Alan, you are welcome to modify the domunentation in
the LCL and send a patch. You can also freely update the wiki docs.
There's no problem about it and you don't have to ask for permission.
That's a bad idea.
The person who wrote the code is the only person who knows what he
intended.
This person has to write the documentation.
Not only that it would take a lot of (unneccessary) additional time to
wade through
foreign code (while the original coder already knew this after writing
it).
Also, every bug would become part of the documentation as it is "how
it is coded".
This doesn't apply to Alan's problem. We try to document important
things. It's not our problem that "it is not enough stressed that
functionality XYZ is not available on ZYX". We really don't have crystal
balls to know what people may think is not enough stressed.
Ondrej
--
_______________________________________________
Lazarus mailing list
Lazarus@lists.lazarus.freepascal.org
http://lists.lazarus.freepascal.org/mailman/listinfo/lazarus