Patch for adding-application portion of Ubuntu docs

Phil Bull philbull at gmail.com
Thu Jun 14 22:25:04 UTC 2007


Hi Jim,

On Thu, 2007-06-14 at 14:42 -0500, Jim Campbell wrote:
> Hello,
> 
> I was working on documentation last weekend with Freddy Martinez, and
> we noticed that the "extra repositories" section of the
> adding-applications portion of the Ubuntu docs covered entering a new
> third-party repository, but didn't cover adding the GPG key for that
> repository.  
> 
> Without a GPG key for third-party repositories, I believe that the
> user is issued a warning stating something to the effect that the
> repository couldn't be authenticated . . . do you want to continue,
> etc.
> 
> Adding this instruction would assist users in those instances.  I've
> validated the changes, but others may suggest different wording . . .
> Let me know what you think.  Thanks.

Looks good! Can I make one small suggestion, though? Could you change
the following paragraph to use fewer technical terms?

<step><para>For security reasons, you will next need to authenticate
this software repository using a <emphasis>GPG key</emphasis>.  GPG is
an algorithm which allows individuals to encrypt and digitally sign
messages and data.  The GPG key should be available for download on the
software repository's website.</para>

Terms like authenticate, algorithm and encrypt/digitally sign seem a
little too technical for what I'd imagine the target audience to be.
After that, it looks pretty much spot on.

Thanks,

Phil

-- 
Phil Bull
http://www.launchpad.net/people/philbull





More information about the ubuntu-doc mailing list