Menu
▾
▴
firebird-docs
|
From: Paul V. <pa...@vi...> - 2004-09-07 00:45:23
|
Hi all, Last week's posting about the updated Quick Start Guide resulted in exactly 0 comments, so I suppose it's acceptable. The latest version (with master font now 11 instead of 10 for easier reading, and titles blue instead of green to move away from the InterBase docstyle) is at http://www.firebirdsql.org/pdfmanual/Firebird-1.5-QuickStart.pdf I'll also redo the other PDFs in the new style, and put up the 1.0 QSG. This may take a little time as the PDFs still need some manual postprocessing after the build :-( Links to the QSG on our website have been updated. Helen, if you're reading this: the release package builders need to be aware of the new QSG and its location. Should I announce it via the admin list, or via the devel list, or email them directly? Greetings, Paul Vinkenoog |
|
From: Helen B. <he...@tp...> - 2004-09-07 01:15:37
|
At 02:45 AM 7/09/2004 +0200, you wrote: >Hi all, > >Last week's posting about the updated Quick Start Guide resulted in >exactly 0 comments, so I suppose it's acceptable. The latest version >(with master font now 11 instead of 10 for easier reading, and titles >blue instead of green to move away from the InterBase docstyle) is at > > http://www.firebirdsql.org/pdfmanual/Firebird-1.5-QuickStart.pdf > Damn, Paul, I meant to post a complimentary comment about it and totally forgot. Both the PDF and the HTML versions are *very impressive*. >I'll also redo the other PDFs in the new style, and put up the 1.0 >QSG. This may take a little time as the PDFs still need some manual >postprocessing after the build :-( > >Links to the QSG on our website have been updated. I'll recheck these links since, up till yesterday at least, we still had docs links pointing to the old version at IBPhoenix. As you know, I'm trying to do a makeover of all this stuff and coordinate the existing, neglected Doc Index with the documentation project. It would have been further forward by now if SF hadn't been offline for a big chunk of the weekend. I've been bogged down in Monday and Tuesday stuff since then. :-( Anyway, you and I need to get our heads together on this. >Helen, if you're reading this: the release package builders need to be >aware of the new QSG and its location. Should I announce it via the >admin list, or via the devel list, or email them directly? Announce it via the Admin list for now, so we can get some informed feedback from the package builders. Once we've settled it, we can put up directions for the package builders regarding documentation. In the past, certain persons argued strenuously against storing binary files on SF at all - hence why we currently don't have a SF repository for the release notes. The SF Admin people have been yelling at us (project admins) regarding our gross overuse of space on the CVS server so, in the long term, making the CVS tree the repository for multiple versions of our PDFs isn't going to win us any friends. These are Admin issues that need to be raised and shaken out for good-and-all. There's a lot I don't know about our file resources on SF, as I'm discovering in the process of wending my way around the website and trying to document it for the new web team. :-( Helen |
|
From: Paul V. <pa...@vi...> - 2004-09-07 01:48:59
|
Hi Helen, > Damn, Paul, I meant to post a complimentary comment about it and > totally forgot. Both the PDF and the HTML versions are *very > impressive*. Thanks! :-) >> Links to the QSG on our website have been updated. > I'll recheck these links since, up till yesterday at least, we still > had docs links pointing to the old version at IBPhoenix. That's correct, I updated them only a few hours ago, in these four locations: homepage sidebar, downloads menu, page_userdoc (added) and manual subproject homepage. I think these are the only locations. > I'm trying to do a makeover of all this stuff and coordinate the > existing, neglected Doc Index with the documentation project. (...) > Anyway, you and I need to get our heads together on this. And hopefully a couple more people... anyway, the documentation pages really need a big overhaul. > The SF Admin people have been yelling at us (project admins) > regarding our gross overuse of space on the CVS server so, in the > long term, making the CVS tree the repository for multiple versions > of our PDFs isn't going to win us any friends. Fwiw, the PDFs (and the HTML) from the manual subproject aren't in the CVS tree, because they can easily be re-rendered from the DocBook sources (which are in CVS) should the need arise. I wonder - are we such a big project? The Firebird home tree (/home/groups/f/fi/firebird) currently uses around 215 M disk space. That includes 145 M in the download subdir, of which 115 M for the 1.5.1. prerelease. Officially, all group homedirs have a 100 M soft quotum. I don't know how much CVS space we use. But since it's practically all source code, what else can we do? Greetings, Paul Vinkenoog |
|
From: Helen B. <he...@tp...> - 2004-09-07 01:59:32
|
At 03:48 AM 7/09/2004 +0200, you wrote: >I don't know how much CVS space we use. But since it's practically all >source code, what else can we do? Actually (OT for docs, sorry) Mark O'Donohue has private stuff stored in his rabbits area, including mp3s. Because the web-visible area is replicated in the cvs tree, on the (wrong) assumption that maintaining the web stuff via CVS would earn us statistics, we actually have all this stuff, including all that garbage, in two places. For bona fide sources, there is no problem asking for more space. The idea was first to get people to clear out their garbage so we'd know how much to ask for. As far as I could tell, I was seeing the PDFs for the manual branch when I was cruising inside the CVS tree. I'll again check this, to make sure that the binaries are not getting duplicated into the web branch by Mark's old scripts.... Helen |
|
From: A6-CMO P. M. <mak...@a6...> - 2004-09-07 07:23:40
|
Le 07/09/2004 02:45, Paul Vinkenoog a écrit : > Hi all, > > Last week's posting about the updated Quick Start Guide resulted in > exactly 0 comments, so I suppose it's acceptable. The latest version > (with master font now 11 instead of 10 for easier reading, and titles > blue instead of green to move away from the InterBase docstyle) is at > > http://www.firebirdsql.org/pdfmanual/Firebird-1.5-QuickStart.pdf > Well done ! so I can start the french translation -- Philippe Makowski |
|
From: Paul V. <pa...@vi...> - 2004-09-09 22:21:58
|
Salut Philippe, >> http://www.firebirdsql.org/pdfmanual/Firebird-1.5-QuickStart.pdf > Well done ! > so I can start the french translation Alors bonne chance! / Good luck! Grtz, Paul Vinkenoog |
|
From: Ernesto C. <ec...@ci...> - 2004-09-10 18:53:34
|
I would like to do a spanish translation of the QuickStart guide. Do I have to do it in docbook? If I do, the translation would be integrated into the doc module? Ernesto Cullen A6-CMO Philippe Makowski wrote: >Le 07/09/2004 02:45, Paul Vinkenoog a écrit : > > >>Hi all, >> >>Last week's posting about the updated Quick Start Guide resulted in >>exactly 0 comments, so I suppose it's acceptable. The latest version >>(with master font now 11 instead of 10 for easier reading, and titles >>blue instead of green to move away from the InterBase docstyle) is at >> >> http://www.firebirdsql.org/pdfmanual/Firebird-1.5-QuickStart.pdf >> >> >> >Well done ! >so I can start the french translation > > > |
|
From: Paul V. <pa...@vi...> - 2004-09-10 20:14:21
|
Hello Ernesto, > I would like to do a spanish translation of the QuickStart guide. > Do I have to do it in docbook? You don't *have to*, but it would be ideal. Do you have experience with DocBook? Even if you don't, translating the sources won't be difficult: the structure and the markup are already there; all you have to do is translate the text between the tags. > If I do, the translation would be integrated into the doc module? That, too, would be ideal. Do you know how to get the sources? Documentation can be found here (HTML version): http://www.firebirdsql.org/manual/firebird-docwriters-info.html and here (PDF version): http://www.firebirdsql.org/pdfmanual/Firebird-Docwriters-Info.pdf And you can always get help here if you're stuck. That said, if you really don't feel up to doing it in DocBook, you can choose another format, and we'll see if and how we can integrate it in the manual module. (Or: you could do the text translation and I could put it in DocBook format. You see... lots of possibilities here :-)) Greetings, Paul Vinkenoog |
|
From: Artur A. <su...@ar...> - 2004-09-09 10:48:05
|
Paul Vinkenoog wrote: > http://www.firebirdsql.org/pdfmanual/Firebird-1.5-QuickStart.pdf Great Work! One small remark: I wonder if it's possible to build some kind of a "front page" for it. Some people will want to print it, and a front page will make the difference. Artur |
|
From: Paul V. <pa...@vi...> - 2004-09-10 11:15:54
|
Hi Artur, >> http://www.firebirdsql.org/pdfmanual/Firebird-1.5-QuickStart.pdf > Great Work! > > One small remark: I wonder if it's possible to build some kind of a > "front page" for it. Some people will want to print it, and a front > page will make the difference. I've been thinking about that too. The Table of Contents could be moved to page 2 (or even 3), so the title page becomes some sort of cover. Finally I didn't do it because the current version is better for on-screen reading. But I'll make a "front page" version this weekend, and we can see which one we like best. It's true that for printed copies, this one doesn't look good - it looks like a draft. Not "classy". Greetings, Paul Vinkenoog |
|
From: Paul V. <pa...@vi...> - 2004-09-14 02:33:02
|
Hi Artur, and all, >> One small remark: I wonder if it's possible to build some kind of a >> "front page" for it. Some people will want to print it, and a front >> page will make the difference. How about this version: http://www.firebirdsql.org/pdfmanual/Firebird-1.5-QuickStart-WithCover.pdf Note: I can easily change position, size and alignment of text and graphics, or remove the top and/or bottom lines. Greetings, Paul Vinkenoog |
|
From: Paul V. <pa...@vi...> - 2004-09-13 15:45:20
|
Hi all, > How about this version: > > http://www.firebirdsql.org/pdfmanual/Firebird-1.5-QuickStart-WithCover.pdf Another note: logo may look crummy on screen, but when printed it's OK. Greetings, Paul Vinkenoog |
|
From: Paul V. <pa...@vi...> - 2004-09-13 21:40:28
|
Hm, this one seems to have gotten "lost in the mail": Hi Artur, and all, >> One small remark: I wonder if it's possible to build some kind of a >> "front page" for it. Some people will want to print it, and a front >> page will make the difference. How about this version: http://www.firebirdsql.org/pdfmanual/Firebird-1.5-QuickStart-WithCover.pdf Note: I can easily change position, size and alignment of text and graphics, or remove the top and/or bottom lines. Greetings, Paul Vinkenoog |
|
From: Artur A. <ar...@ar...> - 2004-09-13 22:50:37
|
Paul Vinkenoog wrote: > How about this version: > > http://www.firebirdsql.org/pdfmanual/Firebird-1.5-QuickStart-WithCover.pdf > > Note: I can easily change position, size and alignment of text and > graphics, or remove the top and/or bottom lines. Paul, for me it's just perfect. Reason: It's simple It has just the info we need: - our logo - the title - author Great! Artur |
|
From: Paul V. <pa...@vi...> - 2004-09-16 12:43:56
|
Hi Artur, [ Quick Start Guide with frontpage + logo ] > Paul, for me it's just perfect. > > Reason: > > It's simple > It has just the info we need: > - our logo > - the title > - author > > Great! OK, I've made it the official version now. I'll also change the stylesheets so that from now on, all PDFs will be rendered like this. Greetings, Paul Vinkenoog |
×
Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.
Thanks for helping keep SourceForge clean.
X