[Lazarus] Missing Documentation

[Mattias Gaertner]

Marco van de Voort <marcov at stack.nl> hat am 28. März 2012 um 16:59
geschrieben:

> On Wed, Mar 28, 2012 at 09:54:01AM +0200, Mattias Gaertner wrote:
> > >
> > > 1. One can be offline, the other not.
> >
> > You can make offline snapshots of the wiki.
>
> Ah, that is working again? Since when?


A db dump is still disabled.
But with a small tool you can download the pages (in wiki format) and
images. A chm converter basically works.



> > And how do I show it? Probably extracting the contents and
> properly relinking and indexing it needs to be redone after each wiki
> migration.


The tool already does the linking.
I also implemented a simple search, which IMO already is quite useful.


The main problem is that currently ipro lacks many html/css features. And
many pages have bugs and non portable tags. These need fixing. I guess a
full week, which I don't have, because 1.0 bug has higher priority.

If someone wants to help, write me a mail.




>
> "wiki" is not an abstract format. Even microsoft word would be better, at
> least that is COM automatable.



>  > > > 2. One is versioned per lazarus version, one is not.
> >
> > A release could have snapshots of both.
>
> That is not the same thing. A zipped copy is not the same as a branch.


True.
But it is sufficient for a release.



>  > > BTW:
> > The update problem already exists in the offline version of the LCL.
> > There are already outdated links and examples.
>
> There is a problem yes. But at least in theory, one could merge back doc
> fixes from trunk to a fixes branch for the next fixes release.


In theory changed wiki pages can be merged back too. It's a simple xml file
per page.



>
> Admitted, neither does FPC, but Lazarus even lacks the theoretical base
for
> this.




Mattias

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.lazarus-ide.org/pipermail/lazarus/attachments/20120328/dc9ac68f/attachment-0003.html>