On Feb 07, 2011, at 11:36 AM, Daniel Holbach wrote: >EXCELLENT WORK! > >A few quick comments: - Is ":rfc:5322" a macro that should do anything? It >looks a bit weird in the generated HTML.
It should be a link to the IETF page for the RFC, but I messed up the markup. Fixed now. > - In "fixing a bug" can we link to how "branching the code" and "proposing a > - merge" works? Good idea, done! >I most confess I'm a bit unsure about the structure of the guide and where >we're going with it. The way I understood our discussions at UDS we >essentially wanted to be task-based and provide articles that help folks to >solve a specific problem (fix a bug, update a package to new upstream >version, etc.) It's clear that by moving from the Wiki docs to the packaging >guide you mostly followed the old structure. One way I can imagine this >working out is by writing articles that explain how to attack a task "in >general" and add a link to some other article if it doesn't pan out because >it's one of those >10% weird cases. (Quick howto that links to in-depth >articles if you really need to understand all of it.) Or maybe split the >whole guide up into "knowledge base articles" vs. "howto guides"? Can you >share your thoughts on it? > >This is an excellent start, even if we should decide to juggle the sections >around a little bit. I totally agree this is just a start. I wanted to make sure the wiki information was faithfully incorporated into the packaging guide docs. I still need to make a pass through /usr/share/doc/bzr-builddeb/user_manual. Once this lands and is available via (even a temporary) web page, I plan to remove/disable the wiki pages and point them at this documentation. But I fully agree that the guide should be reorganized at some point. I like the idea of quick howto-guides and more in-depth kb articles. It's in the latter that we could (possibly) introduce alternative ways of doing things. For example, using sbuild instead of pbuilder. -- https://code.launchpad.net/~barry/ubuntu-packaging-guide/udd/+merge/48685 Your team Ubuntu Packaging Guide Team is requested to review the proposed merge of lp:~barry/ubuntu-packaging-guide/udd into lp:ubuntu-packaging-guide. _______________________________________________ Mailing list: https://launchpad.net/~ubuntu-packaging-guide-team Post to : [email protected] Unsubscribe : https://launchpad.net/~ubuntu-packaging-guide-team More help : https://help.launchpad.net/ListHelp
