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