Ubuntu Documentation - Getting Started

[Doug Smythies]

Hi Everybody,

I got behind on this thread.

On 2013.07.14 11:46 John Kim wrote:

> 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, thanks very much.

For "1": No comment.

For "2": No, we already have a serverguide specific "getting started"
page, with the required apt-get command. The one on this page should be
specific to the desktop docs stuff.
The only reason I left some lines with "not sure if needed for desktop
stuff. Needed for serverguide." Is that I was not sure about them yet,
and still am not. (I got busy with something else for several weeks.)

For 3: So could you make the required edit.

On 2013.07.20 14:36 Phill wrote:

> Just a very minor comment, if the page
> https://wiki.ubuntu.com/phillw/temp_Manual
> gets much longer it may be worth considering splitting it. I recently
> split https://wiki.ubuntu.com/Testing/Activities/JIC into
> https://wiki.ubuntu.com/Testing/Activities It really does depend
> on the finished length, but may be worth considering. If you decide
> to have it split, I'm happy to do so for you while I'm still in
> 'split up large pages' mode :)

A considerable portion of the length is due to the directly "copied"
stuff. Did we reach a consensus about just referencing that material
or keeping the "copied" material? My opinion is that the conversation
died out, rather than reaching consensus.

As for the actual question, do we want to split it up, I have
no comment (don't care either way).

On 2013.08.07 23:30 Phill wrote:

> Can you confirm which page I am to over-write this one onto.

Is this new page not a replacement for, or at least makes
somewhat redundant:

https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/Repository

? More on this further below.
 
On 2013.08.09 16:20 Phill wrote:

> it has been copied over.
To: https://wiki.ubuntu.com/DocumentationTeam/GettingStarted

Yes, but the history information now seems to be for some other
page. Is there a way to also get the related history information?

Also, and to be consistent with the overall structure of the wiki
pages, shouldn't the page be located at:

https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/GettingStarted

?

> if you good people would like some sort of logo,
> then I do know some good graphics people... 
> I'd suggest a header as per https://wiki.ubuntu.com/QATeam 
>
> Maybe having an icon such as we have on
> https://wiki.ubuntu.com/Testing/Activities along with a "corporate
header"?

Icon or logo: I have no comment (I do not care either way).

The header needs to be the standard documentation team header, that
is standard on every doc team wiki page.

However, I propose the following:

1.) Extract and merge into the new page any remaining useful
    information from:
    https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/Repository
    and retire the page. (Note: some sub-pages in the Repository
    directory are still required.)

2.) Change the "Repository" header link to "Getting Started", pointing
    to the new page.

... Doug