Re: [Firebird-docs] A how-to on writing Firebird docs?

[Paul V. <pa...@vi...>]

Hi Tilo (last one for today),

>> 1. A how-to on getting the manual module to work, with:
>>    - getting and installing Java 2
>
> Here I suggest a simple link to the SUN download page.

Yes, that's what I had in mind: no lengthy explanations, just tell
them what they need (at least JRE; JDK if they want to) and where to
get it.

>>    - getting and installing CVS
>
> Why not use this description?
> http://sourceforge.net/docman/display_doc.php?docid=766&group_id=1

It's very lengthy, and specific to WinCVS. I'd prefer to give pointers
to command line CVS, WinCVS and TortoiseCVS. WinCVS is fine, but
TortoiseCVS is so easy and intuitive that it's almost a laugh! It
also has SSH built in, unlike WinCVS.

After that, a short explanation of how to ckeckout the manual module,
with examples for all three programs. Same for update -dP. With
read-only access, that's all they'll ever need.

> I think our goal should be a nightly build of the html docs which
> then can be made available online.

That would be nice. But is this automatable on SF?


Greetings,
Paul Vinkenoog