[Lazarus] Documentation contribution

[Jürgen Hestermann]

Martin schrieb:
>> 4 ff) incomplete, misleading, inconsistent...
>> This is the right place for notes, telling the *experts* to let their 
>> experience shine here.
> Notes that appear in the end user output are inappropriate.
Why that? Better let the end user run into the open knife? I would 
prefer to see such hints if someone already found that something is 
incorrect or misleading. Of course, the best would be a consistent and 
error free documentation but as long as this is not achieved such hints 
are the second best IMO.