[Lazarus] *** GMX Spamverdacht *** Re: Suggestion for TRadioGroup documentation

[Ondrej Pokorny]

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