ubuntu-manual team mailing list archive

[Kevin Godby <godbyk@xxxxxxxxx>]

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