Re: progrerss follow-up

[Milo Casagrande <milo casagrande name>]

Hi Vikram,

I'm re-adding the mailing list.

2009/9/12 Vikram Dhillon <dhillonv10 gmail com>:
>
> Thanks for your reply, I was just thinking that if you can give me the
> source code for that Brasero page I can make a template that can be used
> for every other page, a rather generic one that could apply to any and
> all of the software. If that's possible then it would be just coping and
> pasting stuff from one place to other

You can find the source page here:

http://git.gnome.org/cgit/brasero/plain/help/C/brasero.xml

A basic structure for each topic will absolutely work, but it really
depends how we want to do it: a simple port to Mallard or a rewrite of
the entire help. I'm in favour of the latter, since that's the
direction that all GNOME help will follow. We've done it for Empathy,
we will do it for the user guide, and we can add also Brasero to the
list of the topic-based document (I think also Banshee will be) for
2.30/3.0.

I added the topics brainstormed some time ago with Phil to the wiki,
you can find them here:

http://live.gnome.org/Brasero/Documentation

Those are just some of the questions that will need an answer from
Brasero help. They need to be fixed, sorted out... Basically, in
Mallard each topic will get its own file, and we need a index.page
that will collect them all. You can see the structure of Empathy help
here:

http://git.gnome.org/cgit/empathy/tree/help/C

We will need something like that. We can start sorting out the topics,
order them with a priority and then start writing things down. If you
want to practice with Mallard syntax, porting the old Docbook document
to Mallard could be a good practice.

Ciao.

-- 
Milo Casagrande <milo casagrande name>