[Lazarus] Adding Notes in FPDoc

Sven Barth pascaldragon at googlemail.com
Sat Feb 11 20:49:05 CET 2012


On 11.02.2012 20:35, Michael Van Canneyt wrote:
>
>
> On Sat, 11 Feb 2012, Howard Page-Clark wrote:
>
>> On 11/2/12 3:04, Michael Van Canneyt wrote:
>>
>>>>> Within the <notes> tag, you can include one or more <note> tags.
>>>>
>>>> Why so complicated? Can you give a *reasonable* example of the
>>>> intended usage of this feature?
>>>
>>> Yes. User notes on a website. This website has been in the pipeline for
>>> a long time.
>>
>> The prospect of a website dedicated to discussion of documentation
>> seems to me to be a helpful move forward.
>
> It's not really about discussion (fed up with that, if you can believe
> it ;) ), but about showing and collaborative editing of the docs.
>
> The idea was/is the following:
>
> * All nodes of an FPDoc description file can be put in a database;
> One record per element/module/whatnot, fields for short/descr/seealso
> and whatnot elements.
> I have the structure floating around here somewhere.
>
> * FPDoc needs (or already has, don't remember?) a mode to generate a
> single HTML page,
> based on node name.
>
> * The website can use the fpdoc engine to fetch and display the HTML
> 'on-demand'.
>
> * For people with enough rights, the content can be edited.
>
> * When creating the full docs, the XML is read from the database and
> written to an FPDoc file.
>
> In fact, not so different from a WIKI, but more structured.
>
> And now:
> Since we now have notes, these can be displayed, and edited by all.

Wow... this sounds nice O.O

This will allow to view and edit the documentation of the unfinished FCL 
units as well?

For users without enough rights it will more or less work like the 
current online HTML documentation just for trunk instead of the last 
release?

You will write the backend with FPWeb? :D

I'm looking forward to it! :)

Regards,
Sven




More information about the Lazarus mailing list