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

Jürgen Hestermann juergen.hestermann at gmx.de
Fri Apr 8 20:24:49 CEST 2016


Am 2016-04-08 um 18:18 schrieb Martin Frb:
> Or the person reading the code with the intend of documentation, is more clever than this. They could report any suspicious parts, and clarify the intend. That way the code would be additionally be checked for bugs.
> Bugs where the original implementer may have had a wrong understanding of what he was doing. In which case had the original coder documented it, the bug would have gone into docs.
> Assuming the original coder is available for comment, then a person different from that coder can often write much better documentation. (simple because then 2 (or more) people will have though about what it should be)

I aggree  that this can happen.
But it requires that the reader has at least the same skills
regarding the topic of what has been coded.
How long do you think would it take to (fully) understand the code for VirtualTreeView?
I have already found bugs in it but never understood why they occur
because I do not understand how the whole unit is coded.
So how should I even write documentation for it?





More information about the Lazarus mailing list