Re: [Firebird-docs] Where to start?

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

Hi Armando,

> I think the to-do list is what follows, but I'm not sure:
>
>> Why not take a look at PostgreSQL:
>> http://www.postgresql.org/docs/7.3/static/index.html
>> - A tutorial, great for newbies with databases in general 
>>   and Firebird in particular
>> - From the users point of view, DML, DDL
>> - From the admin point of view, setup, optimize, deploy
>> - Programmer Guide, API
>> - SQL Reference
>> - Developer Guide, also with infos for people willing to 
>>   contribute to Fb

> Please confirm if I got the right one.

Yes, that and a little list I posted earlier in that thread:

> - a DDL guide
> - a DML guide
> - an SQL reference
> - an API guide
> - a Programmer's Guide
> - ...
> - ...

But this was never worked out to something formal. Wouldn't have made
much sense, too, because at the time there was only Tilo and me and a
little later Tilo announced that he didn't have time to write docs
(he's active in the Marathon Project).

> Strangely enough, one of my main concerns about Firebird Docs is 
> beginner docs as I find hard to persuade people to try it without 
> good documentation for beginners.

Maybe you would like to work on updating the Quickstart Guide then?
And later on, (pieces of) Using Firebird.

But feel free to come up with something else.

>> - One existing project that could use input is the Glossary.
>
> Sorry about this Paul, but I'll try to give some help outside the 
> glossary project. That is not really the kind of area I would work 
> on (I hate glossaries and glossaries hate me in return).

OK, stay away from the Glossary - we don't want any bloodshed :-)


Greetings,
Paul Vinkenoog