Ubuntu Documentation - Getting Started

[John Kim]

On 07/14/2013 12:31 PM, Doug Smythies wrote:
> Is not the section "Tools for Ubuntu Documentation Work Flow",
> and as copied from the place [1] Hannie found, actually
> incorrect for the docs application?
>
> The only package I have loaded on my system from the list
> is "gnupg". I do not have "packaging-dev", or several of the
> mentioned sub-components ("pbuilder", "ubuntu-dev-tools",
> "bzr-builddeb", "apt-file"). However, I do build the docs,
> and I need the yelp stuff to do it.
>
> I have edited the section (not finished yet).
>
> I think I (or someone) will have to start with a fresh install
> (perhaps a VM) and follow the instructions to make sure.
>
> [1] http://developer.ubuntu.com/packaging/html/getting-set-up.html
>
> ... Doug
>
>
>

Hi Doug,

I actually went through the entire manual on a fresh 12.04 install on my 
laptop.  For the most part, the guide was very comprehensive and 
helpful, and I feel back in game again.  Here are a few comments.

 1. We should include a section for those who already have gpg keys. It
    may come as a given on what to do, but it would help. For instance,
    I had mine stowed in Dropbox, and I used Password and Keys to import
    my gpg key.
 2. For the sudo apt-get command, we could have a command for installing
    necessary ubuntu-doc stuff and another for installing necessary
    serverguide stuff.
 3. For the section with dch -i, the command needs devscripts. Adding a
    command to install devscripts, if not done yet, would help.

Regarding the packaging-dev stuff, the only thing I needed was devscripts.

-- 
John Kim
Ubuntu Doc & Ubuntu QA contributor
IRC: kotux
"Most folks are as happy as they make up their minds to be." -Abraham Lincoln

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20130720/32b46abc/attachment-0001.html>