Re: [Firebird-docs] Doc Session at FBCon08 - was: 2.0 Langref Update progress

[Björn R. <bjo...@rr...>]

Hello Frank,

  it was a great session showing how fast the doc development
  environment could be set up.
  But the number of attendees was a little bit to low with only 4
  people.

  May be you could publish the presentation somewhere?

> Hi Fabio / all,

> Codebue Fabio - P-Soft wrote:
>> Marvellousssssssssssssssssssssssssssssss
>> 
>> so our dear Frank can explain that there is a very good doc writer team...
>> during his saturday session! 

> actually i was going to post a msg here on exactly that subject,
> so while we're at it ;-) :

> As you probably know, there was a Doc session at last years conference
> where Holger proposed an online Doc database to finally get a complete
> SQL reference guide together. The idea was to start off with just plain
> text so people with no DocBook knowledge could contribute.
> Everybody was enthusiastic about it,
> quite a lot of people said they were going to participate, but after a
> couple of weeks i found myself being the only one to actually write
> stuff - so the whole thing basically died. Nice try, but nothing more
> :-(

> So at this year's conference i'll try to take a different approach:
> I will give a hands-on intro to DocBook, starting with an overall
> overview of DocBook and how it works, followed by a quick run-
> through of the installation and setup for the build environment.
> (us here all know the excellent DocWriter's papers Paul wrote, but
> it won't harm to just show it in the sense of "look, it's that easy
> and it doesn't hurt at all" :-) )

> Then i'll give a short overview of the most common DocBook tags and
> elements (and again point to Paul's paper for more detailed infos).

> Finally i wanted to actually write a bit of DocBook "live", compile
> it and show the html/pdf output so people get an idea of the whole
> process.

> My idea was to take a simple SQL command for the Reference guide,
> based on Paul's Section template, and hopefully make some folks
> interested in doing the same for other commands.

> What i still need to do this is kind of a skeleton LangRef.xml
> where i could put that example into - a "barebone" section alone
> won't compile into a decent pdf... Paul, do you by any chance have
> such a thing already?

> @all: do you have any ideas or comments on the session, or what
> i should show there? (it's not set in concrete, and i'd just
> like to take the opportunity to get the best of attention for
> the Doc project - so any idea is greatly appreciated!)

> (P.S.: if anyone's interested, drop me a note and i can send you
> the Powerpoint presentation as it currently stands)

> cheers,
> Frank





--
Björn