Re: documentation for novice and newbies

2007-02-08 Thread Andrew Sackville-West
Hey guys, I know you're trying to drag as many people as possible into this project, and its great, but maybe there should be a cap on the cross-posting. I think most of us that are interested either already have, or will subscribe to debian-doc. Meanwhile, those of us who already have made the mo

Re: documentation for novice and newbies

2007-02-08 Thread marc
Douglas Allan Tutty said... > Answering this myself, it seems that wikis are flat in that all pages > are under the one main wiki, but any page can reference any other page. It depends on the wiki. I use PmWiki[1], both as a wiki and a development platform for web apps, and it has a number of

Re: documentation for novice and newbies

2007-02-08 Thread Andrei Popescu
CC'd to debian-user On Wed, 7 Feb 2007 22:34:21 - marc <[EMAIL PROTECTED]> wrote: > Douglas Allan Tutty said... > > > If we went with a wiki, we could have one long page for our project > > What's the benefit of doing that? I'm not sure what Doug meant by that, but I was thinking of a main

Re: documentation for novice and newbies

2007-02-08 Thread Andrei Popescu
CC'd to debian-user On Wed, 7 Feb 2007 18:06:13 -0500 Douglas Allan Tutty <[EMAIL PROTECTED]> wrote: > On Wed, Feb 07, 2007 at 05:14:47PM -0500, [EMAIL PROTECTED] > wrote: > > > On Wed, Feb 07, 2007 at 09:24:35PM +0200, Andrei Popescu wrote: > > > > On Wed, 7 Feb 2007 14:14:43 -0500 > > > > Dougl

Re: documentation for novice and newbies

2007-02-07 Thread Douglas Allan Tutty
On Wed, Feb 07, 2007 at 05:14:47PM -0500, [EMAIL PROTECTED] wrote: > > On Wed, Feb 07, 2007 at 09:24:35PM +0200, Andrei Popescu wrote: > > > On Wed, 7 Feb 2007 14:14:43 -0500 > > > Douglas Allan Tutty <[EMAIL PROTECTED]> wrote: > > > > > > So what about novicedoc as a project title? > > > > > >

Re: documentation for novice and newbies

2007-02-07 Thread marc
Douglas Allan Tutty said... > If we went with a wiki, we could have one long page for our project What's the benefit of doing that? > with sub-projects as separate chapters. We can follow the same layout > as a debiandoc e.g. release under GPL, Abstract, TOC, then the chapters. Chapters are go

Re: documentation for novice and newbies

2007-02-07 Thread hendrik
On Wed, Feb 07, 2007 at 02:49:00PM -0500, Douglas Allan Tutty wrote: > On Wed, Feb 07, 2007 at 09:24:35PM +0200, Andrei Popescu wrote: > > On Wed, 7 Feb 2007 14:14:43 -0500 > > Douglas Allan Tutty <[EMAIL PROTECTED]> wrote: > > > > So what about novicedoc as a project title? > > > > > > I don't

Re: documentation for novice and newbies

2007-02-07 Thread Douglas Allan Tutty
On Wed, Feb 07, 2007 at 09:24:35PM +0200, Andrei Popescu wrote: > On Wed, 7 Feb 2007 14:14:43 -0500 > Douglas Allan Tutty <[EMAIL PROTECTED]> wrote: > > So what about novicedoc as a project title? > > > > I don't know what all questions alioth asks when one registers a > > project, but for a sho

Re: documentation for novice and newbies

2007-02-07 Thread Andrei Popescu
On Wed, 7 Feb 2007 14:14:43 -0500 Douglas Allan Tutty <[EMAIL PROTECTED]> wrote: > On Wed, Feb 07, 2007 at 08:51:42PM +0200, Andrei Popescu wrote: > > On Wed, 7 Feb 2007 13:28:56 -0500 > > Douglas Allan Tutty <[EMAIL PROTECTED]> wrote: > > > > I need to look around further at alioth but I _think

Re: documentation for novice and newbies

2007-02-07 Thread Andrei Popescu
On Wed, 7 Feb 2007 13:28:56 -0500 Douglas Allan Tutty <[EMAIL PROTECTED]> wrote: > On Wed, Feb 07, 2007 at 08:09:39PM +0200, Andrei Popescu wrote: > > On Wed, 7 Feb 2007 12:05:27 -0500 > > Douglas Allan Tutty <[EMAIL PROTECTED]> wrote: > > > On Wed, Feb 07, 2007 at 10:46:47AM -0500, [EMAIL PROTECT

Re: documentation for novice and newbies

2007-02-07 Thread Douglas Allan Tutty
On Wed, Feb 07, 2007 at 08:09:39PM +0200, Andrei Popescu wrote: > On Wed, 7 Feb 2007 12:05:27 -0500 > Douglas Allan Tutty <[EMAIL PROTECTED]> wrote: > > On Wed, Feb 07, 2007 at 10:46:47AM -0500, [EMAIL PROTECTED] > We could start a project on alioth. We can setup a repository, > mailinglist, and

Re: documentation for novice and newbies

2007-02-07 Thread Andrei Popescu
On Wed, 7 Feb 2007 11:58:11 -0500 Douglas Allan Tutty <[EMAIL PROTECTED]> wrote: > As far as these discussions go, we should probably move to debian-doc > since this discussion isn't about, directly, solving users' problems. > What say ye? If this seems reasonable, let me know and I'll post this

Re: documentation for novice and newbies

2007-02-07 Thread Andrei Popescu
On Wed, 7 Feb 2007 12:05:27 -0500 Douglas Allan Tutty <[EMAIL PROTECTED]> wrote: > On Wed, Feb 07, 2007 at 10:46:47AM -0500, [EMAIL PROTECTED] > wrote: > > On Wed, Feb 07, 2007 at 09:16:58AM -0500, Douglas Allan Tutty wrote: > > > If we went with a non-wiki format then we need a home. > > > > A h

Re: documentation for novice and newbies

2007-02-07 Thread Douglas Allan Tutty
On Wed, Feb 07, 2007 at 10:46:47AM -0500, [EMAIL PROTECTED] wrote: > On Wed, Feb 07, 2007 at 09:16:58AM -0500, Douglas Allan Tutty wrote: > > If we went with a non-wiki format then we need a home. > > A home on which to develop? or a home on which to publish? > With a distributed revision control

Re: documentation for novice and newbies

2007-02-07 Thread Douglas Allan Tutty
On Wed, Feb 07, 2007 at 03:00:05PM +, Chris Lale wrote: > Douglas Allan Tutty wrote: > >If we were to have a page clearly labled as GPL, would you be able to > >spit out an html of a wiki page any beter than we could pull off with a > >browser? > > I'm not quite sure what you mean. The wiki pa

Re: documentation for novice and newbies

2007-02-07 Thread Douglas Allan Tutty
On Wed, Feb 07, 2007 at 09:58:16AM -0500, [EMAIL PROTECTED] wrote: > On Tue, Feb 06, 2007 at 05:30:10PM -0500, Douglas Allan Tutty wrote: > > Hi all, > > > I have also been subscribed to the debian-doc list which is extremly low > > volume (probably a symptom of why we're having to have this whole

Re: documentation for novice and newbies

2007-02-07 Thread Chris Lale
[EMAIL PROTECTED] wrote: On Wed, Feb 07, 2007 at 03:28:36PM +, Chris Lale wrote: [EMAIL PROTECTED] wrote: [...] I'm in favour of using an open standard for our definitive file format. The obvious one is docbook, since that is used by other Debian documentation. We should at l

Re: documentation for novice and newbies

2007-02-07 Thread hendrik
On Wed, Feb 07, 2007 at 03:28:36PM +, Chris Lale wrote: > [EMAIL PROTECTED] wrote: > >[...] > > > > > >I'm in favour of using an open standard for our definitive file > >format. The obvious one is docbook, since that is used by other > >Debian documentation. We should at least confirm to

Re: documentation for novice and newbies

2007-02-07 Thread hendrik
On Wed, Feb 07, 2007 at 09:16:58AM -0500, Douglas Allan Tutty wrote: > I'm concerned about the newbiedoc wiki: > Its server is sometimes unavailable, so we can't get the debian > www people to add a link. > > As a whole its GFDL although we could do our page GPL. > > I'm c

Re: documentation for novice and newbies

2007-02-07 Thread Chris Lale
[EMAIL PROTECTED] wrote: [...] I'm in favour of using an open standard for our definitive file format. The obvious one is docbook, since that is used by other Debian documentation. We should at least confirm to applicable international standards. We'd still need a mechanism (preferably

Re: documentation for novice and newbies

2007-02-07 Thread hendrik
On Tue, Feb 06, 2007 at 05:30:10PM -0500, Douglas Allan Tutty wrote: > Hi all, > > We've got lots of ideas flowing. Rather than reponding to each post (I > was away for one day and there's a lot on this thread), I'll try to > repond from my perspective to some of the points. In no particular > o

Re: documentation for novice and newbies

2007-02-07 Thread Chris Lale
Douglas Allan Tutty wrote: I'm concerned about the newbiedoc wiki: Its server is sometimes unavailable, so we can't get the debian www people to add a link. As a whole its GFDL although we could do our page GPL. Providing that we are not going to duplicate ef

Re: documentation for novice and newbies

2007-02-07 Thread Chris Lale
Douglas Allan Tutty wrote: On Wed, Feb 07, 2007 at 06:16:47AM +, Chris Lale wrote: Roberto C. Sanchez wrote: On Tue, Feb 06, 2007 at 06:19:00PM -0500, Michael Pobega wrote: > Osamu Aoki edits the Debian Reference etc. This is another possible model for Doug's ideas. Th

Re: documentation for novice and newbies

2007-02-07 Thread Douglas Allan Tutty
On Wed, Feb 07, 2007 at 06:16:47AM +, Chris Lale wrote: > Roberto C. Sanchez wrote: > >On Tue, Feb 06, 2007 at 06:19:00PM -0500, Michael Pobega wrote: > > Osamu Aoki edits the Debian Reference etc. This is another possible > model for Doug's ideas. There are many contributors but the editor

Re: documentation for novice and newbies

2007-02-07 Thread Douglas Allan Tutty
I'm concerned about the newbiedoc wiki: Its server is sometimes unavailable, so we can't get the debian www people to add a link. As a whole its GFDL although we could do our page GPL. I'm concerned about the debian wiki: The front page is immutable due to

Re: documentation for novice and newbies

2007-02-06 Thread Chris Lale
Roberto C. Sanchez wrote: On Tue, Feb 06, 2007 at 06:19:00PM -0500, Michael Pobega wrote: Sounds like exactly what I had in mind, and seems like a pretty good battle plan for jumping into the documentation. What format will the document be written in initially, plain text? I figure if we d

Re: documentation for novice and newbies

2007-02-06 Thread Chris Lale
Douglas Allan Tutty wrote: [...] as I understand it, newbiedoc as a whole is unable to change its licence to GPL from GFDL to make it possible to just migrate it to wiki.debian.org. Is may not be possible just to merge projects like this. You may find it easier to work within an existing

Re: documentation for novice and newbies

2007-02-06 Thread Douglas Allan Tutty
On Tue, Feb 06, 2007 at 06:43:08PM -0500, Roberto C. Sanchez wrote: > On Tue, Feb 06, 2007 at 06:19:00PM -0500, Michael Pobega wrote: > > > > Sounds like exactly what I had in mind, and seems like a pretty good > > battle plan for jumping into the documentation. What format will the > > document

Re: documentation for novice and newbies

2007-02-06 Thread Roberto C. Sanchez
On Tue, Feb 06, 2007 at 06:19:00PM -0500, Michael Pobega wrote: > > Sounds like exactly what I had in mind, and seems like a pretty good > battle plan for jumping into the documentation. What format will the > document be written in initially, plain text? I figure if we do plain > text initially

Re: documentation for novice and newbies

2007-02-06 Thread Michael Pobega
Douglas Allan Tutty wrote: > [...] > > > How does this sound? > > Doug. > Sounds like exactly what I had in mind, and seems like a pretty good battle plan for jumping into the documentation. What format will the document be written in initially, plain text? I figure if we do plain text initially