Re: Getting Up to Speed

[Daniel Espinosa <esodan gmail com>]

> I see that the best way is
> to contribute patches
> (in Docbook for Yelp??), but then while reading the
> mailing list I see that
> a lot of movement is going on in the wiki instead?
> Is this the new preferred
> method of contributing? particularly for user guide
> type documents?

The wiki is useful for several reasons: we can work
collaboratively on documents, which can speed up
writing, and people who don't know DocBook can work on
documents.

However, someone still has to turn wiki markup into
DocBook.
It's also not very convenient for working on a massive
document such as the user guide that has to be spanned
across many pages (then again, neither is DocBook!)

To avoid the spanning of documents, may is better to try to put all the parts as a unique document for each one; that is, for example, in the User Guide (http://live.gnome.org/DocumentationProject_2fUserGuide), the chapter talking about Multimedia and his sub-titles, must be in the same document; may this is better for the documenter contributtor and next for the convertion to DocBook; I'll work on that ASAP.

-- 
Trabajar, la mejor arma para tu superación
"de grano en grano, se hace la arena" (R) (entrámite, pero para los cuates: LIBRE)