From: Nando D. <na...@de...> - 2004-03-23 05:52:26
|
Hello, first of all, kudos to everyone for the grat work that's going on here. I hope I'll be able to contribute something myself. 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. :-) Having said this, perhaps it would be a good idea to integrate such documentation with the Firebird documentation from the start. Comments? -- Nando Dessena mailto:na...@de... |
From: Nando D. <na...@de...> - 2004-03-24 07:59:44
|
BTW, I have received a notice saying that my mail to this list is moderated since I have not subscribed. I don't want to represent a source of more work for whoever is moderating the list, nonetheless I'm not sure what should I be subscribed to to be able to post freely here. I thought subscribing to the list was enough. :-) Clarifications welcome. -- Nando Dessena mailto:na...@de... |
From: Darcy O'N. <ds...@sk...> - 2004-03-24 12:38:20
|
Hello Nando, Welcome to the Firebird Doc group! As for your question I think for now what you can do is develop your documentation in the same style and format as the Firebird docs. See http://vinkenoog.nl/firebird/drafthowto/ Right know we are trying to get some good database documents developed. Trying to add more work to this project at the moment would not good. However, absolutely feel free to contribute ideas towards documentation on this list. Part of the process is developing a series of professional documents along with the standard docs (HTML, XML, PS, TXT) and we need as many opinions as possible. This information may also help you in the development of your own project. Darcy O'Neil Nando Dessena wrote: >Hello, >first of all, kudos to everyone for the grat work that's going on here. >I hope I'll be able to contribute something myself. > >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. :-) > >Having said this, perhaps it would be a good idea to integrate such >documentation with the Firebird documentation from the start. > >Comments? > > |
From: Nando D. <na...@de...> - 2004-03-24 13:03:45
|
Darcy, D> Welcome to the Firebird Doc group! Thank you. Been lurking here for a while, actually. D> As for your question I think for now D> what you can do is develop your documentation in the same style and D> format as the Firebird docs. See http://vinkenoog.nl/firebird/drafthowto/ I'll study the docs and come back when I have a clearer idea of what's needed. D> Trying to add more work to this project at the moment would not good. I'm not sure I follow you here. I'm not porposing anyone should do more work to please my needs. ;-) I just wonder how much should it be integrated with the Firebird docs themselves. If the tool is going to be distributed with Fb, chances are it will be the first approach for new users to the software, hence the first piece of documentation people will look for (the kind of people who actually read docs, anyway). I guess that using the guidelines above will facilitate integration if needed in the future, so I'll stick to them. D> However, absolutely feel free to contribute ideas towards documentation D> on this list. Will do, thanks. Ciao -- Nando Dessena mailto:na...@de... |
From: Paul V. <pa...@vi...> - 2004-03-24 16:01:48
|
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 |
From: Paul V. <pa...@vi...> - 2004-03-24 16:08:42
|
Hi Nando, > I have received a notice saying that my mail to this list is > moderated since I have not subscribed. I don't want to represent a > source of more work for whoever is moderating the list, Pavel Cisar. > nonetheless I'm not sure what should I be subscribed to to be > able to post freely here. I thought subscribing to the list was > enough. :-) I works like this: if you subscribe to the mailing list (via email or via the list page at SF) you can mail to the list (of course) and you can also post through the Atkin news interface. In both cases your messages will go to the list immediately. If you're not subscribed to the mailing list you obviously can't mail to it (well you can, but it bounces :-)) but you *can* post through the news interface. However, in that case your message is held until Pavel approves it. This is necessary to stop all the spam that used to be posted. Maybe you posted to the newsgroup from another email account than the one you subscribed to the mailing list with? Greetings, Paul Vinkenoog |
From: Nando D. <na...@de...> - 2004-03-24 17:45:25
|
Paul, P> Maybe you posted to the newsgroup from another email account than the P> one you subscribed to the mailing list with? my fault. I posted (through SMTP) with a different e-mail account. I didn't notice it because one account forwards to the other, and I almost never use the old one. Now everything is OK. Thanks -- Nando Dessena mailto:na...@de... |
From: Nando D. <na...@de...> - 2004-03-24 18:05:11
|
Paul, P> Iirc you also wrote in FFmembers that once ready, the lightweight P> version would be "donated" to the Firebird project. I suppose that P> means transfering the sources to the firebird project at SF? well, I'm not writing code (though I am participating in the design) so I can't speak for the developers, but they would be happy to make the tool part of the Firebird project *and* continue to maintain it (if the Firebird project accepts both the code and the developers, of course). I don't know if the license and other bits are compatible, though (not my field really). P> wouldn't it be better to start an fbmanager (or fowl, or whatever) P> module in firebird right away and develop it there? OTTOMH I can't see why not. I have just forwarded your idea to fbmanager-devel. P> I don't know how much you know already about the manual setup close to nothing, but I will be traveling in the next few days and I have downloaded the docs I need to read... P> we have all the documents in one DocBook <set>. One of the advantages is P> that we can easily link to any other document in the set. If you would P> develop the fbmanager documentation within the Firebird manual module, P> we can all benefit from this. P> The best approach IMO is to make a separate <book> for the fbmanager P> documentation. OK, so it would be a <book> and that <book> will be part of the whole <set>. Sounds right. P> You can find the most recent version of the Howtos at the doc P> subproject homepage: P> http://www.firebirdsql.org/index.php?op=devel&sub=doc I'll be offline, so I've downloaded Darcy's pdf for the time being. I hope it's enough for a start. Ciao -- Nando Dessena mailto:na...@de... |
From: Paul V. <pa...@vi...> - 2004-03-25 14:14:15
|
Hi Nando, > well, I'm not writing code (though I am participating in the design) > so I can't speak for the developers, but they would be happy to make > the tool part of the Firebird project *and* continue to maintain it > (if the Firebird project accepts both the code and the developers, > of course). I don't know if the license and other bits are > compatible, though (not my field really). The overall project license is MPL in both cases. IPL applies only to code that originates from Borland. Greetings, Paul Vinkenoog |
From: Helen B. <he...@tp...> - 2004-03-25 14:33:48
|
At 03:12 PM 25/03/2004 +0100, you wrote: >Hi Nando, > > > well, I'm not writing code (though I am participating in the design) > > so I can't speak for the developers, but they would be happy to make > > the tool part of the Firebird project *and* continue to maintain it > > (if the Firebird project accepts both the code and the developers, > > of course). I don't know if the license and other bits are > > compatible, though (not my field really). > >The overall project license is MPL in both cases. IPL applies only to >code that originates from Borland. Ummm, the overall project licence is **not** MPL. The Jury (read project Admins) is still out on what licence to use for new code. It is not likely to be MPL. It's likely to end up being IDPL (Initial Developer's Public License). Reason for eschewing MPL is the control Mozilla/Netscape has over the licence. The IDPL is distributed with Firebird 1.5 - see the Firebird root directory. It is, like the IPL, a MPL derivative. Helen |
From: Paul V. <pa...@vi...> - 2004-03-25 15:30:31
|
Hi Helen, [ fbmanager - firebird ] >> The overall project license is MPL in both cases. IPL applies only >> to code that originates from Borland. > Ummm, the overall project licence is **not** MPL. The Jury (read > project Admins) is still out on what licence to use for new code. > It is not likely to be MPL. It's likely to end up being IDPL > (Initial Developer's Public License). Reason for eschewing MPL is > the control Mozilla/Netscape has over the licence. On the Project Summary Page it says: License: Mozilla Public License 1.0 (MPL) That's why I assumed this was our overall or "default" license. > The IDPL is distributed with Firebird 1.5 - see the Firebird root > directory. It is, like the IPL, a MPL derivative. Thanks - I must admit I've never looked at it! ;-) Greetings, Paul Vinkenoog |