[Lazarus] Documentation rev33561

Graeme Geldenhuys graemeg.lists at gmail.com
Thu Nov 17 08:05:36 CET 2011


On 17/11/2011, Felipe Monteiro de Carvalho <felipemonteiro.carvalho at g...> wrote:
>
> If you don't know what a method does, don't change it's description,
> but don't put [?] in the documentation and also don't write that you
> don't know what something does.

I have to agree with Felipe here. Seeing [?] inside the documentation
itself does give the documentation a "bad smell". Why not simply use
the comment tags [eg: <!-- my comment here -->] inside the XML files.
That way it doesn't appear inside the documentation context, but the
XML is searchable to find areas that need to be addressed by somebody
else.


-- 
Regards,
  - Graeme -


_______________________________________________
fpGUI - a cross-platform Free Pascal GUI toolkit
http://fpgui.sourceforge.net




More information about the Lazarus mailing list