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