Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-doc
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-doc@g.o
From: Xavier Neys <neysx@g.o>
Subject: Re: Wiki for official docs only
Date: Sun, 12 Jul 2009 17:48:11 +0200
AllenJB wrote:

> The basic idea is to replace the current documentation with something
> that's much easier to edit.
> 

> On top of that the Handbooks in particular are (at a glance) a maze of
> multiple files pieced together into the finished product (I haven't got
> round to checking whether this maze is mapped out anywhere yet - I had
> multiple things on my todo list at the time and decided to just move on
> to the next item).

Easy, refresh your anoncvs, create a debug.xml file in your document root that 
contains
<debug on="1"/>

and voilĂ , you see the file names.

> On the other hand, I (and I suspect a large number of other people in
> general) use wiki's quite a lot, am familiar with the syntax and find
> them a breeze to edit. In my opinion, it is likely the the official
> documentation would receive more, faster contributions if they were on a
> wiki instead of built using GuideXML.

In other words, you want the current docs team to learn a new syntax and a new 
tool, and infra to install a new system because you can't learn a dozen simple 
tags, you know like <p> for a paragraph...


Wkr,
-- 
/  Xavier Neys
\_ Gentoo Documentation Project
/
/\ http://www.gentoo.org/doc/en/


Replies:
Re: Wiki for official docs only
-- AllenJB
References:
Wiki for official docs only
-- AllenJB
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Wiki for official docs only
Next by thread:
Re: Wiki for official docs only
Previous by date:
Wiki for official docs only
Next by date:
Re: Wiki for official docs only


Updated Apr 08, 2012

Summary: Archive of the gentoo-doc mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.