← Back to team overview

ubuntu-manual team mailing list archive

Re: Places or Go?

 

Hi Jim,
I think it is me who has to apologize here, not you. When I woke up this morning, the first thing I thought was: wait a minute, Places is part of the Gnome menu bar, which is also mentioned in our manual. Before I dive into this (later, because I am leaving in a minute) I wanted you to know that perhaps it was I who wrongly put this subject on the list.
Hannie
p.s.: who says we do not care :) I even dreamt of Places!

Op 15-07-12 20:37, Jim Connett schreef:

Hey all.....looks like the section in question is one that I edited and I missed this, and I apologize. Because someone else had authored the section, I was more focused on grammar/linguistics and less focused on functional accuracy with this being my first involvement in this process. I see now that I'll have to focus on both parts, equally, in future editions.

To have spelling or grammar errors in this manual is one thing....to have contextual issues is quite another. While it may be a little more work, I would be in favor of working on a 'version 2' release of the manual after another round of edits. This is, after all, an LTS manual. Seems like we also have disagreements with other terminology used in the current version of the manual, so another revision, would serve multiple purposes.

We also have to coordinate with translators as well...if we pursue a 2nd rev. Even so, if this wasn't an LTS verion I wouldn't be as concerned, but since it is, I think it's worthy of some consideration.

I'll do whatever I can do to help remedy this situation.

Jim

On Jul 15, 2012 8:43 AM, "Kevin Godby" <godbyk@xxxxxxxxx <mailto:godbyk@xxxxxxxxx>> wrote:

    On Sun, Jul 15, 2012 at 3:10 AM, Hannie Dumoleyn
    <lafeber-dumoleyn2@xxxxxxxxx <mailto:lafeber-dumoleyn2@xxxxxxxxx>>
    wrote:
    > In the precise version I found:
    >> To access \menu{Places}, move your mouse over the top bar and
    select
    >> \menu{Places}.

    It's kind of a silly sentence to begin with. "To access File, move
    your mouse over the top bar and select File." By the time the reader
    gets to this place in the manual, one would hope that he/she knows how
    to access pull-down menus.

    > I do not have a menu item Places in my Precise version. I guess
    it should be
    > \menu{Go}.

    It's even worse than that.  There's an entire subsection dedicated to
    this non-existent Places menu.

    ubuntu-desktop/ubuntu-desktop.tex
    179:\subsection{Places}
    181:To access \menu{Places}, move your mouse over the top bar and
    select \menu{Places}. \marginnote{If you do not see the desktop menu,
    click somewhere on the desktop and it will appear.}
    182:The \menu{Places} menu holds a list of commonly used folders (such
    as \menu{Documents}, \menu{Music}, \menu{Downloads}, and the
    \menu{Home Folder}). You can also browse the files on your computer by
    clicking \dropdown{Computer} in this menu. If you set up a home
    network, you will find a menu item to access shared files or folders.
    You can also access the \dropdown{Search for Files} tool from the
    \menu{Places} menu, or browse a list of recently opened folders.
    205:  \item[left page] The left pane of the file browser has shortcuts
    to commonly used folders. When a folder is bookmarked, it appears in
    the left pane. No matter what folder is open, the left pane will
    always contain the same folders. This left pane can be changed to
    display different features (such as Information, Tree, History, etc.)
    by clicking the down arrow beside ``Places'' near the top.

    > I think we should change this in an update because it is
    confusing for new
    > users if they get the wrong information, especially in an LTS
    version.
    >
    > Besides, the word top bar could be replaced by menu bar.

    I'd prefer not to release a new edition of the manual each time we
    find a bug. Releasing a new manual takes some time and work and I
    think we may be better off spending that effort on starting 12.10.
    I'd suggest that as we find these bugs in the 12.04 version of the
    manual we immediately fix them in the quantal repository. That way the
    12.10 version of the manual is starting off better.

    What do others think?

    --Kevin

    _______________________________________________
    Mailing list: https://launchpad.net/~ubuntu-manual
    <https://launchpad.net/%7Eubuntu-manual>
    Post to     : ubuntu-manual@xxxxxxxxxxxxxxxxxxx
    <mailto:ubuntu-manual@xxxxxxxxxxxxxxxxxxx>
    Unsubscribe : https://launchpad.net/~ubuntu-manual
    <https://launchpad.net/%7Eubuntu-manual>
    More help   : https://help.launchpad.net/ListHelp




References