[Mono-docs-list] RE: Organizing docs, DocBook?

[Felix Faassen]

Hi Norman,

Docbook is the way to go, I agree. Maybe it's a good idea I make a
little start in a single DocBook XML file, I can always split the files
later to conform to the framework we'll eventually will use.



On Fri, 2002-12-20 at 07:00, Norman Lorrain wrote:
> Felix,
> 
> I'm trying Borges now, but it's geared towards Linux, which causes
> problems for me (mainly in the structure of the makefiles, even using
> GNU/make).  Perhaps we can adapt it, I'm sure Mono has addressed this
> problem for their makefiles.
> 
> Perhaps we can address this later.  Better to get started on this.  I
> might try to get a Linux box working over Christmas.
> 
> The raw tools (OpenJade, etc.) are definitely cross-platform, it's the
> extra stuff (document tracking, work-in-progress) that might be
> questionable.
> 
> I still think Docbook is a good idea.
> 
> 
> 
> 
> > -----Original Message-----
> > From: mono-docs-list-admin@ximian.com [mailto:mono-docs-list-
> > admin@ximian.com] On Behalf Of Felix Faassen
> > Sent: December 19, 2002 8:13 PM
> > To: Mono Docs List
> > Cc: Norman Lorrain
> > Subject: [Mono-docs-list] RE: Organizing docs, DocBook?
> > 
> > Hi Norman,
> > 
> > How's it going with your framework? Can't wait to see more.
> > 
> > I came by a Docbook publishing system also. It's called Borges, which
> is
> > the framework which has been created by Mandrake and it's used for the
> > creation
> > of the mandrake docs. It supports a multilangual and modulair setup.
> > When you create a new project it can be copied into a CVS repository
> and
> > everybody can start working on different parts.
> > 
> > I had it up and running in 10 minutes
> > 
> > More about it on  http://linux-mandrake.com/en/doc/project/Borges/
> > 
> > 
> > Good luck!
> > 
> > Felix
> > 
> > 
> > On Wed, 2002-12-18 at 21:54, Norman Lorrain wrote:
> > > This page is from the FreeBSD project (they use docbook)
> > > http://www.freebsd.org/docproj/sgml.html
> > >
> > > They have an excellent primer here:
> > >
> http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/index.html
> > >
> > > I happen to use FreeBSD here; I'll try to set up a skeleton project
> and
> > > see how tough it can be.  When it's up I'll post a link.
> > >
> > >
> > > I'd also be happy to convert the Gnome.net tutorial, if that's what
> we
> > > decide.
> > >
> > >
> > >
> > > ---
> > > Outgoing mail is certified Virus Free.
> > > Checked by AVG anti-virus system (http://www.grisoft.com).
> > > Version: 6.0.427 / Virus Database: 240 - Release Date: 12/06/02
> > >
> > >
> > >
> > 
> > 
> > 
> > _______________________________________________
> > Mono-docs-list maillist  -  Mono-docs-list@ximian.com
> > http://lists.ximian.com/mailman/listinfo/mono-docs-list
> > 
> > ---
> > Incoming mail is certified Virus Free.
> > Checked by AVG anti-virus system (http://www.grisoft.com).
> > Version: 6.0.427 / Virus Database: 240 - Release Date: 12/06/02
> > 
> 
> ---
> Outgoing mail is certified Virus Free.
> Checked by AVG anti-virus system (http://www.grisoft.com).
> Version: 6.0.427 / Virus Database: 240 - Release Date: 12/06/02
>  
> 
> 
> _______________________________________________
> Mono-docs-list maillist  -  Mono-docs-list@ximian.com
> http://lists.ximian.com/mailman/listinfo/mono-docs-list
>