On Mon, 24 Aug 2009, Mattias Gärtner wrote:

Zitat von Graeme Geldenhuys <[email protected]>:

Jesus Reyes wrote:

If you haven't noticed, in 0.9.29 one event OnValidateCell has been
added to StringGrid, there is something in
http://wiki.lazarus.freepascal.org/Grids_Reference_Page#Validating_Entered_Values
about how this work which is basically what was requested in the
original thread.

And to reiterate my reply to the original thread. Why is such
documentation not in the LCL fpdoc format, but rather the wiki?

One reason: no one has explained how to do that.


Such
documentation should be located in ONE location only. Scattered
documentation is just as good as NO documentation. Users have no clue
what is the latest documentation either. There are some LCL StringGrid
fpdoc documentation, but it seems the wiki has more information. As to
which one is newer / more up-to-date, I have no clue!

PLEASE consider the idea of having documentation in ONE place only.

The important goal is to refer/navigate easily between all documentations.
The wiki contains some howtos and links to further help. The fpdoc files should have "see also" links to these pages. And we need an offline version of the wiki pages for download. And they should be packaged (e.g. added to the windows installer).

Graeme, if you want to move the wiki content to svn, then you need to provide:
- a conversion tool for wikis
- an easy to use export utility (because help must be readable without installing lazarus).
- a fancy editor
- support for translations

What is the problem with fpdoc ? It has all this ?

The only thing that is missing is the ability to let people create/modify
fpdoc entries over the web. This can be easily written, it is somewhere in
my todo list. If that particular item is moved up in the priority list
you can dump the wiki and have ready-help with the possibility for end-users
to contribute.

(@joost: you were looking for something nice to demonstrate fpWeb with: here it
is...)

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

Reply via email to