Ubuntu Documentation and UDS-M

Kyle Nitzsche kyle.nitzsche at canonical.com
Tue Apr 6 16:22:30 UTC 2010


Hi all,

With UDS coming up, what sessions on Ubuntu documentation should there be?

A few ideas:

Mallard and Ubuntu Docs: the Plan
 * I would personally love to see a fairly thorough presentation here 
(when, what, how, translations, etc.)
 * Can topics be put in a desired sequence?
 * Can/should topics that are not official be excluded from official 
guide pages? (or clearly labeled)
 
Mallard and Ubuntu Docs and Translations (seems big enough to warrant a 
separate session)
 * Are translation regressions expected?
 * What steps need to be taken to convert existing docbook translations 
to Mallard?
 * Should the transition to Mallard be incremental if translation 
regressions are significant?

The Ubuntu Docs User Experience:
 * How might it evolve to better meet user needs?
 * What's missing?
 * Does the beginning user get what they need?
 * Does the advanced user get what they need?
 * Is the current lack of screen shots acceptable/are there any topics 
for which the benefit might outweigh the cost?
 * is the current approach of the web (help.ubuntu.com) the right approach?

Modularizing Ubuntu Docs
 * Will Ubuntu Docs continue as a single package, or might the New To 
Ubuntu topic (for example) be separately packaged to facilitate 
customization for ubuntu variants

Ubuntu Docs and Language Packages (is this needed?)
 * If New To Ubuntu (or any other topic) is separately packaged, how can 
the translations get into lang packs?

Ubuntu Manual: The Plan
 * Here too it would be nice to see it all put together and presented
 * Including plans for the LIVE-CD (if any)

Ubuntu Manual and Ubuntu Docs: Content Sharing
 * Seems like there is common content, but different source formats (tex 
vs docbook/mallard)

Cheers,
Kyle






More information about the ubuntu-doc mailing list