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!
[...] 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 [...]
GREAT WORK!
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!
[...] 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. ← [...]
Nice idea. Unfortunately the survey is for people who already know how to make packages. What about someone who would like to start?
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!
[...] 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 [...]
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!