Open Week - another docs day?

[Alex Lourie]

Matthew, Phil

If the open docs day is all about docs, it could be "splitted" to various
parts, each according to
its technical level.

So, we could have "complete beginners" part, which would introduce the team,
its work and will be
almost without technical details (or, at least, without specifics).

Then, we could have "Docteam Fun" part, where people could learn new things
after they already
joined and/or participated in some action. It can definitely include some
technical details.

And then we could have "Advanced Documentation" part, where all the new
trends and technologies could
be reviewed.

In this case, the Mallard lecture could easily go into the 3rd part, and
there would be no mistake about its
purpose and target audience. We don't want new people to begin learning how
to write Mallard documentation
before they know what the Doc Team is for.

That is, of course, just a suggestion, and in "final" version it should
invite everyone to all the lectures. No one should
feel unwelcome at any point.

Alex.


On Tue, Sep 29, 2009 at 12:00 AM, Matthew East <mdke at ubuntu.com> wrote:

> On Mon, Sep 28, 2009 at 10:48 PM, Phil Bull <philbull at gmail.com> wrote:
> > Since Mallard is conceptually simpler (and more fun to write in!), I'd
> > prefer to train people in that and let them fiddle with DocBook if they
> > like. IMHO, DocBook has lots of baggage which results in a steeper
> > learning curve and requires beginners to worry about silly technical
> > details.
> >
> > I understand that new contributors wouldn't be ready for DocBook
> > immediately if we only trained them in Mallard, but we could do some
> > follow-up work to fill them in on DocBook's quirks.
>
> Ok, I don't have a problem with that.
>
> --
> Matthew East
> http://www.mdke.org
> gnupg pub 1024D/0E6B06FF
>
> --
> ubuntu-doc mailing list
> ubuntu-doc at lists.ubuntu.com
> https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20090929/4d4befca/attachment.html>