Mattias Gaertner schrieb:

    Documentation rework, removes aprox. 600 occurences of [?] and other
non-sense from the documentation
Thanks. It seems the pattern is [...?].

Dodi, is this the only pattern?

See StyleGuide.txt:

Everybody can add revision marks.
I use brackets for now, to indicate passages with questionable content:
[?] unclear wording, possibly wrong. Long: [what's this?]
[???] unreadable or definitely wrong description.
[~] somebody else should make this proper and nice English.
[!] Incompatible or wrong implementation, e.g. [Delphi incompatible!]

When such notes shall no more be added, please update this file accordingly.


One last note:
When it is unwanted or impossible to add notes to the documents in e.g. FPDoc Editor, what's the preferred procedure then? Are bug reports required, or what's the suggested way to ask for clarification or correction of incomplete or wrong documentation?

DoDi


--
_______________________________________________
Lazarus mailing list
[email protected]
http://lists.lazarus.freepascal.org/mailman/listinfo/lazarus

Reply via email to