Saucy desktop docs review spreadsheet

[Phill Whiteside]

Hi,

let me also take off about all of my hats :) Between my work on QA /
Testing for lubuntu, helping other community flavours etc. I do spend time
on wiki areas and do give the odd poke to teams to have a productive sprint
for updating areas so that new comers can understand the basics. I have
been *told off* in the past for expecting too much prior knowledge for our
QA / Testing classroom sessions and have really taken that on board.

As there is a lot of new stuff going on for wiki / documentation / manual;
in my very humble opinion, can we concentrate not only on the 'do the best
we can for 13.10' but ensure that we have, on all areas and flavours, a
firm footing for to invite newcomers in for 14.04. The insight that new
comers is, IMHO, vital; after all, we are writing this stuff for them!
Making it less scary for them to get involved should be a very high
priority, they are keen to help... It is vital that we bring them in,
listen to what they like and what they do not like etc. We who have been
around several cycles can too easily forget the trepidation a new comer
faces.

The QA / testing area has been made more 'new comer' friendly [1] to [2]
The Docs team have just moved their sand-box area to being live [3] (Yes, I
know it says temp Manual!!). These are a bit late in the cycle, but I
certainly hope that docs and manual team do also concentrate a bit of time
and effort so that after the 13.10 lands, both manual and doc teams can
hold classroom sessions early on (as in the 1st month) to encourage new
comers (that also includes those who have been around several cycles, but a
bit overwhelmed by the instructions)

@ Liz, you'll need to put your classroom head back on for this :D The QA /
Testing people already know from the last vUDS that it will be all in place
earlier than last cycles.

Regards,

Phill.
1. https://wiki.ubuntu.com/Testing/Activities?action=recall&rev=49
2. https://wiki.ubuntu.com/Testing/Activities
3. https://wiki.ubuntu.com/phillw/temp_Manual



On 2 September 2013 00:01, Stephen Michael Kellat <smkellat at yahoo.com>wrote:

> Let me take off my LoCo leader hat and put on my "Xubuntu Documentation"
> hat.
>
> Another key thing to remember is that Ubuntu Manual is not packaged let
> alone seeded to ship on any disc.  The various documentation packages for
> Ubuntu and the flavors are.  Documentation is different in focus from a
> manual which is why we focus on ensuring it ships and why there are
> specific freeze deadlines.  That is also why when it comes to Feature
> Freeze Exception requests we can object, strenuously if need be, if a
> change is going to force us to rewrite too much documentation.
>
> Let the manual project do their own thing.  With Feature Freeze in place
> we need to ship the best possible documentation for all flavors.  I'll have
> to consult with my flavor's docs lead as to our priorities as we wind up
> the Saucy Salamander cycle.  I know that Lubuntu and Xubuntu previously
> shipped pidgin-microblog on disc but since that package is so broken it is
> now no longer seeded on any flavor's disc image for Saucy...and we do need
> to check if anybody's documentation still talks about it!
>
> Stephen Michael Kellat
>
>
> On Sun, 1 Sep 2013 14:44:45 -0700
> Elizabeth Krumbach Joseph <lyz at ubuntu.com> wrote:
>
> > On Sun, Sep 1, 2013 at 2:35 PM, Jonathan Aquilina
> > <eagles051387 at gmail.com> wrote:
> > > To be honest what is the difference between the teams. Isnt there the
> same
> > > goal for both teams in the end?
> >
> > The projects certainly are similar, but they have different outputs
> > and specific needs to meet those goals.
> >
> > The docs team is specifically targeted at created system documentation
> > that ships with Ubuntu. As such it's written with common documentation
> > frameworks (Desktops docs now use Mallard, formally used Docbook and
> > some doc projects still do in Ubuntu) and is released officially in
> > multiple versions (shipped on the desktop, as HTML for
> > help.ubuntu.com). It contains a lot of links to stitch it all
> > together.
> >
> > The Manual is more of a book style (not really linked to separate
> > pages) that has downloadable by PDF and also available for purchase as
> > a very inexpensive paper book.
> >
> > --
> > Elizabeth Krumbach Joseph || Lyz || pleia2
> > http://www.princessleia.com
> >
> > --
> > ubuntu-doc mailing list
> > ubuntu-doc at lists.ubuntu.com
> > https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
>
> --
> ubuntu-doc mailing list
> ubuntu-doc at lists.ubuntu.com
> https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
>



-- 
https://wiki.ubuntu.com/phillw
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20130902/a78d95ce/attachment.html>