Does "Files, Folders and Documents" need to be a distinct chapter

Bug #700347 reported by Book 'em Dano
10
This bug affects 1 person
Affects Status Importance Assigned to Milestone
xubuntu-docs (Ubuntu)
Fix Released
Low
Book 'em Dano
Lucid
Fix Released
Undecided
Unassigned

Bug Description

Binary package hint: xubuntu-docs

As the files-and-docs.xml file appears now, it only provides links to other sections in the documentation and does not provide any unique substantial information. The file is formatted as a chapter and when it is rendered in yelp or in a browser, it gives the impression that Files, Folders and Documents will be a substantive chapter, I felt misled upon reading it and only discovering links to other chapters/sections. Perhaps files-and-docs.xml could be integrated could into another chapter/section, since it is curt.

Revision history for this message
Charlie Kravetz (cjkgeek) wrote :

Thank you for reporting this issue. Examining the documentation, I see no reason to keep this chapter. Since all it is doing is telling users to go read the other chapters, it is not adding useful information.

Changed in xubuntu-docs (Ubuntu):
importance: Undecided → Low
status: New → Triaged
Revision history for this message
Book 'em Dano (heymrdjd) wrote :

fix committed to revision 256 in natty

Changed in xubuntu-docs (Ubuntu):
assignee: nobody → Book 'em Dano (heymrdjd)
status: Triaged → Fix Committed
Revision history for this message
Martin Pitt (pitti) wrote : Please test proposed package

Accepted xubuntu-docs into lucid-proposed, the package will build now and be available in a few hours. Please test and give feedback here. See https://wiki.ubuntu.com/Testing/EnableProposed for documentation how to enable and use -proposed. Thank you in advance!

Changed in xubuntu-docs (Ubuntu Lucid):
status: New → Fix Committed
tags: added: verification-needed
Revision history for this message
Charlie Kravetz (cjkgeek) wrote :

Verified the xubuntu-docs are correct in 10.04.1, using a fresh installation in VirtualBox, fully updated before enabling proposed. Thanks for the hard work getting this done.

tags: added: verification-done
removed: verification-needed
Revision history for this message
Launchpad Janitor (janitor) wrote :
Download full text (8.4 KiB)

This bug was fixed in the package xubuntu-docs - 9.10.1.10.04.1

---------------
xubuntu-docs (9.10.1.10.04.1) lucid-proposed; urgency=low

  [Book 'em Dano]
  * desktop-guide/about-xubuntu/C/about-xubuntu.xml:
    - inputted correct format of command (LP: #653881)
    - changed entity for distro version number
  * desktop-guide/add-applications/C/add-applications.xml:
    - added reference to Ubuntu Software Center & other revisions (LP: #647187)
    - various revisions
    - added appropriate tags, capitalized section titles
    - provided instruction on how to install package using Gdebi, restructured
      appearance of file
  * desktop-guide/administrative/C/administrative.xml: added appropriate tags,
    revised instructions on how to grant/restrict administrative access
  * desktop-guide/basic-commands/C/basic-commands.xml:
    - corrected variable & stdout
    - added appropriate tags, capitalized section titles
  * desktop-guide/config-desktop/C/config-desktop.xml:
    - updated instructions how to enable window effects & change windows themes
      & icons
    - restructured appearance of code; added appropriate tags; commented out
      section pertaining to Menu Editor as it has been removed from Xfce 4.6
    - added appropriate tags, inputted correct entity
    - revised instructions to add and select new theme
  * desktop-guide/games/C/games.xml: added reference to Ubuntu Software Center &
    other revisions (LP: #647187)
  * desktop-guide/hardware/C/hardware.xml:
    - added reference to Ubuntu Software Center & other revisions (LP: #647187)
    - capitalized section titles, updated url for laptop testing & revised
      instructions on how to activate/deactivate restricted/third-party drivers,
      choose a blank screen as screensaver, commented out pm-general-method
      section as it is obsolete (LP: #461158)
  * desktop-guide/index.xml:
    - commented out reference of files-and-docs.xml to remove from "Files,
      Folders and Documents" chapter as it contains nothing other than links to
      other sections (LP: #700347)
    - Commented out this reference as Advanced Topics chapter does not have any
    unique substantive material, (LP: #700351)
  * desktop-guide/internet/C/connecting.xml:
    - added appropriate tags, corrected grammatical errors, added appropriate
      tags, provided full names for acronyms
    - revised instructions on how to connect to Mobile Broadband, VPN and DSL
      connections
  * desktop-guide/internet/C/connecttoserver.xml: changed directions to reflect
    usage of Gigolo (LP: #644867); changed user interaction verbs, changed tags
    & capitalized section titles
  * desktop-guide/internet/C/disconnecting.xml: added appropriate tags
  * desktop-guide/internet/C/information.xml: added appropriate tags
  * desktop-guide/internet/C/networking.xml: capitalized section titles, changed
    tags, provided instructions on how to share folders with Shared Folders
    application
  * desktop-guide/internet/C/nm.xml: added appropriate tags, corrected
    grammatical errors
  * desktop-guide/internet/C/troubleshooting.xml:
    - added appropriate tags, capitalized titles of sections, revised
      in...

Read more...

Changed in xubuntu-docs (Ubuntu Lucid):
status: Fix Committed → Fix Released
Revision history for this message
Launchpad Janitor (janitor) wrote :
Download full text (9.3 KiB)

This bug was fixed in the package xubuntu-docs - 11.04.0

---------------
xubuntu-docs (11.04.0) natty; urgency=low

  [ Book 'em Dano ]
  * desktop-guide/about-xubuntu/C/about-xubuntu.xml:
    - inputted correct format of command, LP: #653881
    - modified entity/path to access Software Sources through Ubuntu Software
      Center, LP: #649530
    - added tags
  * desktop-guide/add-applications/C/add-applications.xml:
    - added reference to Ubuntu Software Center & other revisions, LP: #647187
    - changed tags to provide consistency
    - added tags & expounded on instruction to install deb file with GDebi
    - corrected tags
    - added appropriate tags, capitalized titles of sections, inputted entity
      for Xubuntu
    - modified entity/path to access Software Sources through Ubuntu Software
      Center, LP: #649530
    - added colon per Style Guide, capitalized section title
  * desktop-guide/administrative/C/administrative.xml:
    - revised instruction on how to add administrative access to user
    - added appropriate tags, revised instructions on how to grant/restrict
      administrative access
    - changed user interaction verbs, changed tags & capitalized section titles
  * desktop-guide/config-desktop/C/config-desktop.xml:
    - added tags, corrected sentence structure
    - added appropriate tags, restructured appearance of file, revised
      instructions on how to enable desktop effects & change desktop themes,
      commented section about Menu Editor as it was removed from Xfce 4.6
    - added colon per Style Guide, capitalized section title
  * desktop-guide/games/C/games.xml: added reference to Ubuntu Software Center &
    other revisions, LP: #647187
  * desktop-guide/hardware/C/hardware.xml:
    - added reference to Ubuntu Software Center & other revisions, LP: #647187
    - revised instructions on how to use Additional Drivers & corrected
      grammatical errors
    - updated instructions & updated url for laptop testing
    - corrected grammatical errors, changed structure of file, added
      instructions to install xfce4-fsguard-plugin, LP: #672217
    - capitalized section titles, commented out pm-general-method section as it
      is obsolete, LP: #461158
  * dkestop-guide/index.xml:
    - commented out reference of files-and-docs.xml to remove "Files, Folders
      and Documents" chapter as it contains nothing other than links to other
      sections, LP: #700347
    - commented out this reference as Advanced Topics chapter does not have any
      unique substantive material, LP: #700351
  * desktop-guide/internet/C/connecttoserver.xml:
    - changed directions to reflect usage of Gigolo, LP: #644867
    - changed user interaction verbs, changed tags & capitalized section titles
  * desktop-guide/internet/C/disconnecting.xml: changed user interaction verbs,
    changed tags & capitalized section titles
  * desktop-guide/internet/C/nm.xml: changed user interaction verbs, changed
    tags & capitalized section titles
  * desktop-guide/internet/C/networking.xml: revised instructions on how to
    allow access to folders over networks, capitalized sections titles,
    restructured appearance of file
  * des...

Read more...

Changed in xubuntu-docs (Ubuntu):
status: Fix Committed → Fix Released
no longer affects: xubuntu-docs (Ubuntu Maverick)
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.