OpenWeek Session

[Matthew East]

On Thu, Apr 9, 2009 at 4:24 PM, Emma Jane Hogbin <emmajane at ubuntu.com> wrote:
> Rockin' the docs!! I'm filling in Friday, but I can switch to Tuesday if
> that's easier for Matthew to move?

Friday is likely to be a bit easier for me, all things being equal.
But I can only do an evening slot, such as 20 or 21 UTC. So if we're
going to try and use a whole day, then I will probably step back and
let others drive the sessions, and just join when I can. We certainly
need to structure the sessions so that they are logical and
progressive. At the moment we have several sessions up on the schedule
which overlap with each other.

> I'd love to have the following sessions:
>
> 1. The Docs Team: overview of wiki, system documentation and mailing list
> 2. The wiki: our lowest hanging fruit, learn how to contribute here first
> 3. System documentation: The help button, the server guide and what it
> means to be "official" docs
> 4. Bugs and docs: how the doc team fixes mistakes and how you can help
> 5. The Tool Chain for system docs: tool chain overview
> 6. Bazaar: how to get the system docs
> 7. DocBook: reading and loving XML markup
> 8. Translation: intro to pot files and rosetta

These are all things which we should touch on, but most of these don't
justify a whole session. I think we can justify the following
sessions:

1. Introduction to the docteam. The Wiki  - what it is, learning the
markup and our wiki best practices (WikiGuide)
2. The System Documentation - what they are, how to get them (bazaar),
and learning the markup (docbook)
3. Documentation translation - issues and best practices

Session 2 is obviously a big one, but I don't think it should be split
into two sessions, because the information is very much inter-reliant.
Instead I think it can last two hours, rather than one (maybe with a
short break). That way we have 4 hours worth of sessions on the
ubuntu-doc project, which is very good, and at the same time not over
the top in terms of hogging the timetable.

They could be placed between 18:00 and 22:00 on Friday or another
convenient day, it depends who is available to run the sessions. I
could be around for most of that timescale.

These would be separate to the sessions which Adi has proposed:
running a localization team and creating loco resources - these
certainly justify separate sessions and are outside the scope of the
docteam.

-- 
Matthew East
http://www.mdke.org
gnupg pub 1024D/0E6B06FF