Usability of 'Manually Mounting and Unmounting File Systems'

Bug #117382 reported by Duncan Lithgow
8
Affects Status Importance Assigned to Milestone
Gnome Documentation
Unknown
Low
gnome-applets (Ubuntu)
Invalid
Low
Unassigned
gnome-user-docs (Ubuntu)
Invalid
Undecided
Unassigned

Bug Description

Ubuntu 7.04 (Feisty Fawn)

In the section of the user documentation called 'Manually Mounting and Unmounting File Systems' there is a reference to "such as USB and IEEE1394 disks". I think few users who need to read that document would know what IEEE1394 is and anyone who knows what IEEE1394 is will also know that it's commonly called firewire.

I suggest the reference be changed to refer to Firewire instead of IEEE1394.

Tags: feisty
Revision history for this message
Jonathan Jesse (jjesse) wrote :

Changed to confirmed

Changed in ubuntu-docs:
status: New → Confirmed
Revision history for this message
Aaron Ahlemeyer (fatespeaks) wrote :

The original text of the "Disk Mounter Manual", Section 1.2 is as follows:
" Some systems may also automatically mount some removable media (such as USB and IEEE1394 disks), these devices may also come up in the Disk Mounter so that you can unmount them when you are finished, and provide a visual indication that they are present."

IEEE1394 is the standard name for this interface. "Firewire" is the Apple brand name, just like i.Link is the Sony brand name. In my experience (United States), FireWire is the most commonly used term. However, IEEE1394 is the most correct term.

If any change is made, it should refer to IEEE1394, FireWire, and i.Link. But this should only be changed if there is value in being able to find this section by a keyword search of the new terms. Otherwise, the page is fine as it is.

Note: I just searched the help system on my Ubuntu Feisty system for these terms and received the following result counts:
"firewire" 3
"ieee1394" 1
"ieee-1394" 1
ilink, i-link, and i.link all returned 0.

Perhaps there would be value in using consistent terminology throughout the documentation.

Cheers,
Aaron

Revision history for this message
Aaron Ahlemeyer (fatespeaks) wrote :

This help document is from the file: /usr/share/gnome/help/drivemount/C/drivemount.xml
On Feisty, this file is installed by the package: gnome-applets-data
According to comments in drivemount.xml, the file is maintained by the GNOME Documentation Project.

Revision history for this message
Mads Peter Rommedahl (lhademmor) wrote :

In that case, perhaps this should be forwarded upstream? I tried, but I couldn't figure out which version of the application had the problem and so on...

Revision history for this message
Mads Peter Rommedahl (lhademmor) wrote :

Can anyone decide if this deserves to be changed or not? I could move ahead with it, but I need a clear answer...

Revision history for this message
Mads Peter Rommedahl (lhademmor) wrote :

Changing to incomplete

Changed in ubuntu-docs:
status: Confirmed → Incomplete
Revision history for this message
Matthew East (mdke) wrote :

Yes, the bug should be moved upstream. I'll assign it to the correct Ubuntu package in the meantime.

Please don't set bugs as "incomplete" unless there is outstanding information requested from the user.

Changed in ubuntu-docs:
status: Incomplete → Confirmed
Revision history for this message
Pedro Villavicencio (pedro) wrote :

leaving as incomplete until it gets forwarded upstream.

Changed in gnome-applets:
importance: Undecided → Low
status: New → Incomplete
Revision history for this message
Mads Peter Rommedahl (lhademmor) wrote :

Has been forwarded now.

Changed in gnome-user-docs:
status: Unknown → New
Revision history for this message
Pedro Villavicencio (pedro) wrote :

Comment from upstream: "This is probably a Ubuntu addition. I didn't find this text in GNOME package.", rejecting the other task one is enough here, thanks.

Changed in gnome-applets:
status: Incomplete → Invalid
Changed in gnome-user-docs:
status: New → Invalid
Changed in gnome-user-docs:
importance: Unknown → Low
status: Invalid → Unknown
Revision history for this message
Connor Imes (ckimes) wrote :

I'm not finding this section in the current docs anymore. Does anybody know if it still applicable?

Changed in gnome-user-docs (Ubuntu):
status: Confirmed → Incomplete
Revision history for this message
Duncan Lithgow (duncan-lithgow) wrote :

I can no longer find any reference to either firewire or ieee1394. Marking as invalid in gnome-user-docs

Changed in gnome-user-docs (Ubuntu):
status: Incomplete → Invalid
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.