← Back to team overview

ubuntu-manual team mailing list archive

Re: [Ubuntu Manual] Ubuntu Desktop chapter needs you !


Hello Jim,
Thank you for joining us. I can see you have already been active as an editor and even pushed your first changes to chapter 2.
I like your enthusiasm :)
Here are some answers to your questions:
On this sheet [1] we keep track of who does what. At this moment all chapters, with the exception of "The Ubuntu Desktop", have authors assigned to them, hence the call for authors/editors for this chapter. c7p is responsible for the assignment of authors to chapters, so anyone who wants to contribute as an author to this chapter will be contacted by him. I do the editors assignments. I will send you, and others who offered their help for the editing part of this chapter, a separate email shortly. As for the tag added when committing: Commit them with a good description. Not word-for-word changes, but specific enough for someone to easily find again. If you still have any questions, either send them to this list, or join us on irc: #ubuntu-manual.

[1] https://docs.google.com/spreadsheet/ccc?key=0Ar0Z6vOO38EydEdaSnhSX2M2WDdSZ3VGQk1qMDZBbHc#gid=1

Op 22-05-12 04:55, Jim Connett schreef:
Hello everyone, I'm Jim Connett, and I'm very interested in helping to edit this section.

I'm new to this documentation effort, but I've finally taken the plunge and installed everything needed to be an author and/or editor. Because of my education and background, I prefer to be an editor rather than an author, but will eventually want to do both as time allows.

I'm up-to-speed on the LaTeX formatting from the well-written guide and have even started perusing Chapter 2 since it looks like this is where our focus resides. I have two questions.

1) It looks like edits made should be "justified" in comment tags...meaning, who did it, what was changed, and why. Is this required, optional, or just a professional courtesy?

2) In reading the email threads over the last few days, it looks like editors are assigned to parts of the document. Should someone be assigning me my first editing duties, or shall I just grab a section and go for it and let everyone know where I'm at? I know this is a community effort, but I also don't want to step on anyone's efforts.

I've read through the current manual already...well-written, definitely a good resource for those who are new to Ubuntu. I also see areas for improvement linguistically, and I look forward to contributing to this effort!

So...any last words-of-wisdom before I jump in with both feet?

Thanks!  Look forward to working with all of you in this effort.


On Mon, May 21, 2012 at 1:21 AM, Hannie Dumoleyn <lafeber-dumoleyn2@xxxxxxxxx <mailto:lafeber-dumoleyn2@xxxxxxxxx>> wrote:

    Op 21-05-12 00:20, John Cave schreef:
    I thought that I was doing this section. The new ubuntu has not
    changed that much from the last, I observe, so mostly what will
    be needed is new screenshots and maybe expanding the chapter. I
    can do the job of scanning the chapter for changes, but
    expansions may need to be done by someone else.

    John C

    I do not agree that the new Ubuntu has not changed that much. When
    I read the current chapter "The Ubuntu Desktop" (based on the
    Oneiric version) I see many things that need to be changed, too
    much to mention here. In fact, I think the chapter needs a
    complete overhaul. The order of subsections needs reshuffling.
    Examples: I see a description of the Launcher on page 25, and the
    section Using Launcher on page 27. I see Top Bar on page 24 and a
    screenshot of the Top Bar(?) of a window on page 28. In Unity the
    Top Bar has replaced the individual title bars in the applications
    themselves, although some older applications still have there own
    title bar.
    So, I agree with c7p, who wrote:

    The Ubuntu Desktop section needs your help ! This part of the
    chapter covers the basics of the Ubuntu Desktop environment (Login
    screen, Unity, Launcher, Dash, windows, workspaces, HUD).

    We need an author for this section cause it's one of the most
    critical sections of the manual, maybe the most important. Are you
    interested ?

    One option would be to have more authors and editors assigned to
    this chapter (Tony, Vibhant, John, Hannie) where each has his/her
    own specialty like Dash, Unity, Launcher, Nautilus etc.

    Let me know what you think.

    Mailing list: https://launchpad.net/~ubuntu-manual
    Post to     : ubuntu-manual@xxxxxxxxxxxxxxxxxxx
    Unsubscribe : https://launchpad.net/~ubuntu-manual
    More help   : https://help.launchpad.net/ListHelp