Re: "Start here" document for the live CDs

[Luis Villa <luis villa gmail com>]

On 5/22/05, Marcus Bauer <mbauer tiscali fr> wrote:
> We should have kind of a "start here" document for the desktop which we
> can push over to the translation teams.
>
> My suggestions (to be discussed/extended)
>
> format: html

I would guess (and we really need to ask the i18n people about this)
that the right format is docbook, because:

 * it can be translated with existing tools (xml2po)
 * we can automatically generate nice pdfs for printing/distribution
at conferences
 * we can automatically generate HTML for the web if we need it
 * in yelp, we have a more appropriate viewer than we do for HTML (or
at least shaun told me that could be done :)

> content:
>
>   * short marketing text: about gnome
>     - free, easy, powerful, efficent etc. etc.
>
>   * where to get further info / online help, whom to contact
>
>   * success stories (100.000 desktops by spanish administration,
>     500.000 by brasilian administration)
>
>   * some words about the shiniest apps (gimp, inkscape, abiword,
>     gnumeric come to my mind)
>
> Please have a look what is already available on the english live CD
> (Luis: could you give a pointer for an online source outside the CD?)

There are two key ones on the liveCD:
A general gnome project overview, which touches on a lot of the things
you've discussed:
http://cvs.gnome.org/viewcvs/*checkout*/livecd-project/root-dir/etc/skel/Desktop/GNOME%20Project%20overview.abw

a liveCD overview, to explain to people what to do with the liveCD,
what to play with, etc.:

http://cvs.gnome.org/viewcvs/*checkout*/livecd-project/root-dir/etc/skel/Desktop/LiveCD%20Overview%20%28start%20here%21%29.abw

This isn't quite as critical but it is still important.

These are currently in abiword format, but I'm totally flexible about
dumping that if someone wants to use abi's docbook export and clean it
up so that we have a starting point. I wrote them in abi originally
because I was under time pressure and wanted decent formatting, and
didn't think I could do that quickly in docbook given how rusty my
docbook is.

Luis