[Lazarus] FPDoc tracker

[Hans-Peter Diettrich]

Michael Van Canneyt schrieb:

>> Can namespaces serve the same purpose?
> 
> I'm not sure I understand what you mean ?
> 
> If you're talking about XML namespaces, forget it. Way too complicated 
> and bloated.
> But maybe you meant something else?

No, I meant exactly the XML namespaces, for which I found methods in the 
XML classes. But I'm not very familiar with XML, so I leave it to the 
gurus to work out solutions :-)


>>> Experience with the FPC website shows that chances of having 
>>> multi-language documentation are virtually 0. Basically, I think the 
>>> FPC/Lazarus community is too small for the effort it takes.
>>
>> Well, the community might grow when there exists better and 
>> nationalized documentation.
> 
> I seriously doubt that, but hope springs eternal, of course :-)
> 
>> IMO the procedures and tools for improving the FPDoc documentation are 
>> not well known, and translations make no sense without the 
>> multi-language display feature :-(
> 
> Well, we all know pascal, the sources are there.

*We* do, but nowadays nobody else knows Pascal. IMO the Pascal community 
will die with our generation, if we (and Embarcadero) don't find ways to 
recruit new members.

> I also had to learn it 
> by diving in, because I inherited the project from its original author.

The lack of translated documentation is a mess, and differing 
(outdated...) translated documenation also is a mess. That's why I try 
to provide a documentation managment system, which allows to keep 
multiple document versions in sync. Such tools exist for general 
wordprocessing systems, but not for the special formats of the help sources.

BTW, many people have problems with the wiki documentation as well. The 
lack of an index is annoying, it only encourages unsystematic 
documentation where nobody can find relevant information without 
assistance. Content search is almost useless for non-English speakers, 
which don't know about the right keywords.

DoDi