Xubuntu Docs

Sat Jan 8 04:44:46 UTC 2011

I've only checked sections 1 - 6 so far, but I think Book 'Em Dano has done
a great job on them and I'm looking forward to seeing some up-to-date
documentation in Natty :-)

I have the following comments / suggestions.  There are a few points that I
think need a bit of discussion, so I have summarised these are the bottom of
this mail.

1.  The "New to Xubuntu 11.04?" page has a previous page link that links to
itself - this should link to "Xubuntu 11.04 Documentation".

2.  The "What is Xubuntu?" page has a previous page link that links to
itself - it should link to "Xubuntu - Linux for Human Beings!".

3.  On the "How can I upgrade to the latest version of Xubuntu?" page, an
alternative Step 1 is "Applications ▸ System ▸ Update Manager, then select
"Settings" and enter your password when prompted.".  I find the Update
Manager way is much quicker, but I guess we should be pushing the Software
Centre where possible?  Either way, we should add the fact that you have to
enter your password.

4.  I've not used any version of Windows since XP, but do the instructions
in section "3.1.2.3. Proxy server settings" work for Windows Vista and
Windows 7?

5.  Ditto for "3.1.3.1. Home networks".

6.  Section "3.1.5. Web browser bookmarks" has no instructions for backing
up Chrome bookmarks.  Perhaps we should add these?

7.  Section "3.1.5.1. Internet Explorer" gives instructions for backing up
Internet Explorer 6 bookmarks.  Should we consider updating these to cover
IE7 and / or IE8?

8. Section "3.1.7.2. CD or DVD disc" covers writing CDs in Windows XP.
 Should we consider including instructions for Windows Vista and Windows 7?

9. Section "3.2.1. Files" states "To access your Home folder, press Places ▸
Home Folder."  I think that this should be either "To access your Home
folder, double-click the "Home" icon on the desktop." or "To access your
Home folder, press Places ▸ User Name." (as other areas of the docs use).
 The user's Home folder is not called "Home folder" in any of the menus.

10. Section "3.2.1. Files" also states "You may find it useful to create
folders for different types of files, such as music and photos.".  Xubuntu
comes with folders called "Documents", "Music", "Pictures" and "Videos" as
standard, so why not mention these here instead of suggesting the user
create folders?

11. Section "3.2.1. Files" Step 3 states "You can open your Home folder by
clicking File ▸ New Window.".  The actual command is "File ▸ Open New
Window".

12. Section "3.2.1. Files" Step 4 states "In the window corresponding to the
disc you inserted, press Edit ▸ Select All.".  The actual command is "Edit ▸
Select all Files".

13. Section "3.2.1.1. Importing Photos" suggests that the user might like to
install F-Spot.  Should we be suggesting Shotwell now that it's the Ubuntu
default and updating this section accordingly?  If not, Step 3 ("Install the
F-Spotapplication") needs a space between "F-Spot" and "application".

14. Section "3.2.1.1. Importing Photos" Step 1 suggests the user should
create a folder called "Photos" in their Home folder.  Why not suggest they
use the default "Pictures" folder?

15. Section "3.2.1.2. Importing Music" states that Listen is the default
music player.  It's now Exaile, so this section need updating accordingly,
including Step 5 which refers to Rhythmbox.

16. Section "3.2.1.2. Importing Music" Step 1 suggest the user should create
a folder called "Music" in their Home folder.  This folder already exists in
a default Xubuntu install.

17. Section "3.2.2. Emails" states "If you saved your emails from Windows,
you may now want to import them into the Evolution mail client.".  This
should read "If you saved your emails from Windows, you may now want to
import them into the Mozilla Thunderbird mail client.".

18. Section "Glossary of Windows Terms" -> My Documents states "Inside your
home folder (Places ▸ Home Folder), you can arrange documents and other
files in whatever folders you wish.".  This should read "Inside your home
folder (Places ▸ User Name), you can arrange documents and other files in
whatever folders you wish.".

19. Section "Glossary of Windows Terms" -> Recycle Bin states "The Trash
works much the same way as the Recycle Bin. The Trash is almost always at
the bottom right corner of the screen.".  In my locale (EN-GB), this applet
is called Wastebasket,  but I'm not sure about other locales.

20. Section "Glossary of Windows Terms" -> Standby states "To put your
computer into a power-saving mode until you resume using it, choose
Applications ▸ Log Out, then Suspend or Hibernate.".  On both my netbook and
desktop installs, the Suspend and Hibernate options are no longer available
from this menu and can now be found by clicking the Xfce Power Manager
applet.

21. Section "Glossary of Windows Terms" -> Task Manager states "To see or
halt currently running programs, or to track processor and memory usage,
choose Applications ▸ System ▸ Task Monitor.".  This should either read
"Applications ▸ System ▸ System Monitor" or "Applications ▸ System ▸ Task
Manager", depending upon which application was meant.  My preference would
be for "Applications ▸ System ▸ Task Manager" as I think this is more akin
to the Windows Task Manager.

22. Section "5.1.1. Top Panel" states "It also comes with a logout button,
system tray, a network manager application and a clock.".  The applet that
provides the system tray is called "Notification Area", so should we call it
a notification area?

23. Section "5.1.2 Bottom Panel" states "The pager allows you to navigate
between the different desks you use. Note that small icons on the pager give
an indication about the current windows on the different desks.".  The
"desks" are usually called "Workspaces" (for example in the Settings
Manager), so should we call them "Workspaces" here?

24. Ditto for section "5.1.3. Desktop ... Using the scroll wheel...".

25. The part of Section "5.2.1. Navigation" referring to the Shortcut Pane
lists two shortcuts, Home and Filesystem.  The default (I think) has 9:
Home, Trash/Wastebasket, Desktop and Filesystem in the top section, plus
Documents, Download, Music, Pictures and Videos in the bottom section.  This
part also suggests that a users Home folder will probably be empty, but the
default install comes with at least 5 folders: Documents, Download, Music,
Pictures and Videos.

26. Section "5.2.2. Creating and Deleting Files" states "To create a new
document, right-click on some empty space in your home directory and select
Create New Document ▸ Empty File from the pop-up menu.".  The correct
command is "Create Document ▸ Empty File".

27. Section "5.2.4. Removable Devices" states "To remove the CD, right-click
on the shortcut, and choose Eject Volume. The same applies for any other
removable media.".  To remove other removable media you select the "unmount"
option, not the "Eject Volume" option.

28. Section "6.1.2. Copy from a CD" states "Exaile stores ripped files in
the Home folder (Places ▸ Home Folder).".  This should read "(Places ▸ User
Name).".

29. Sections "6.3.1. Import photos from a digital camera", "6.3.2. Organize
your photo collection", "6.3.3. Watch a slideshow of photos",
"6.3.5. Sharing your photos" and "6.3.6. Edit and improve photos" all refer
to F-Spot.  Shouldn't we update these to refer to Shotwell?

**********
Summary of points for discussion:

Should we provide instructions for backing up Chrome, IE7 and IE8, as well
as the browsers currently listed?

Should we provide instructions for burning CDs / DVDs in Windows Vista and
Windows 7 (I've not used either but I'm assuming the existing XP
instructions won't be correct for Vista & 7).

Should we suggest Shotwell instead of F-Spot now that Shotwell is the Ubuntu
default?

**********
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/xubuntu-devel/attachments/20110108/0a98a9da/attachment.html>