Re: [Firebird-docs] FbManager documentation

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

Hi Nando!

> Now to the subject of this message: I am in charge of writing
> documentation for a project that has the temporary name of
> "FbManager", which aims to be a simple, lightweight, cross-platform
> GUI for Firebird (think of it as a graphical isql + gbak +
> gsec). Once it's finished, we would like to have it distributed
> together with Firebird so newbies (especially under Windows) notice
> they have actually installed something. :-)

Iirc you also wrote in FFmembers that once ready, the lightweight
version would be "donated" to the Firebird project. I suppose that
means transfering the sources to the firebird project at SF? If so,
wouldn't it be better to start an fbmanager (or fowl, or whatever)
module in firebird right away and develop it there?

> Having said this, perhaps it would be a good idea to integrate such
> documentation with the Firebird documentation from the start.

If fbmanager is going to move over to Firebird: absolutely. If it
remains an SF project of its own, it all depends on what's convenient
for you guys. For the Firebird Documentation subproject it would be a
great plus to have the fbmanager docs aboard, because after all this
_is_ going to be the "official" Firebird GUI, distributed with it - or
at least with some packages.

I don't know how much you know already about the manual setup, but we
have all the documents in one DocBook <set>. One of the advantages is
that we can easily link to any other document in the set. If you would
develop the fbmanager documentation within the Firebird manual module,
we can all benefit from this.

The best approach IMO is to make a separate <book> for the fbmanager
documentation.

You can find the most recent version of the Howtos at the doc
subproject homepage:

  http://www.firebirdsql.org/index.php?op=devel&sub=doc

The versions at vinkenoog.nl may be slightly different. I'll replace
them with links to the offcial Firebird site.


Greetings,
Paul Vinkenoog