We’d like to get your input on where to focus documentation efforts on the Ubuntu Packaging Guide. There are all kinds of topics that need to be written, updated, or improved — so where should we start? What do you need most?
Give your input via the this Google Docs Survey. I’ve provided some direction by asking you to focus on tasks, concepts, and terminology that can be best documented in the Packaging Guide, but you’ll no doubt have other ideas.
If you’re interested in writing on a particular topic, please be sure to note that in the survey comments (and include your name and email address!). I’ll be sure to ping you once we get the new guide outlined and stubbed out.
Also, if you have any suggestions for the packaging guide that aren’t encompassed in the survey, please feel free to leave a comment here.
Thanks!
P.S. Oh, and wouldn’t you know that the Mozilla documentation team is updating their Mozilla Developer Network documentation, too? Janet Swisher from their docs team published a note seeking developer input on how their docs can be improved. She publishes her blog content under a CC by SA 3.0 license, so I’ve “borrowed” some of her phrasing. Hi, Janet!


Tweets that mention notes from the mousepad » Blog Archive » Updating the Ubuntu Packaging Guide -- Topsy.com
Jul 13th, 2010
[...] This post was mentioned on Twitter by Planet Ubuntu. Planet Ubuntu said: Jim Campbell: Updating the Ubuntu Packaging Guide: We’d like to get your input on where to focus documentation eff… http://bit.ly/axBXun [...]
Daniel Holbach
Jul 14th, 2010
GREAT WORK!
Gerfried Fuchs
Jul 14th, 2010
It would be swift if you could consider for the next such survey that there are also people who do original packaging within Debian as an option to some of the question. Getting feedback from those people might give a good insight too, and having them try to figure out which option sound least wrong to them isn’t really encouraging for submitting the results.
Did submit it anyway, thanks for working on the document!
Ubuntu Packaging Guide Survey | Daniel Holbach’s blog
Jul 14th, 2010
[...] guide. If you used the guide in the past, like it, and/or want it improved, please check out his announce. This entry was posted in MOTU, OpenSource, People, Ubuntu. Bookmark the permalink. ← [...]
mmiicc
Jul 14th, 2010
Nice idea. Unfortunately the survey is for people who already know how to make packages. What about someone who would like to start?
jim
Jul 14th, 2010
Hey there, mmiicc,
The survey _is_ intended more for people who are already doing at least some packaging . . . but my goal is to make use their feedback to make the guide helpful for someone who would like to start.
Please feel free to fill out the survey (or at least answer questions where you can . . . ). There are no “required” questions, and all input is valuable, particularly if you’ve tried to package before and have gotten “stuck” on something.
Thanks for leaving a comment!
Updating the Ubuntu Packaging Guide | Ubuntu-News - Your one stop for news about Ubuntu
Jul 14th, 2010
[...] Give your input via the this Google Docs Survey. I’ve provided some direction by asking you to focus on tasks, concepts, and terminology that can be best documented in the Packaging Guide, but you’ll no doubt have other ideas. More here [...]
Janet Swisher
Jul 14th, 2010
Hi Jim! The Mozilla Hacks blog where I posted that note is not exactly *my* blog, but it is CC-BY-SA, and you’re welcome!