ubuntu-manual team mailing list archive

[Jim Connett <jimandmarcy@xxxxxxxxx>]

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> wrote:

> On Sun, Jul 15, 2012 at 3:10 AM, Hannie Dumoleyn
> <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
> Post to     : ubuntu-manual@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~ubuntu-manual
> More help   : https://help.launchpad.net/ListHelp
>