"Advanced Topics" is curt, brief

Bug #700351 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
Low
Book 'em Dano

Bug Description

Binary package hint: xubuntu-docs

Similar to bug 700347, the "Advanced Topics" chapter is misleading. As it appears as a chapter when rendered, I thought before looking at it, that it would contain some unique valuable information, but sadly, it only contains links to other sections in documentation. Perhaps a reference to Advanced Topics could be integrated the "Basic Commands" section or other appropriate section/chapter since "Advanced Topics" is extremely brief.

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

Thank you for reporting this issue. I view "Advanced Topics" as a chapter that needs expansion. It should be telling our users that the basic items anyone can do are not the limit of what is possible. However, if we delete this chapter and later can write a chapter that does expand on this, can it be added back easily? Of course, later sometimes means "very many months/years in the future", too.

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 276 in lucid, revision 242 in maverick & revision 267 in natty

Changed in xubuntu-docs (Ubuntu):
assignee: nobody → Book 'em Dano (heymrdjd)
status: Triaged → Fix Committed
Changed in xubuntu-docs (Ubuntu Lucid):
importance: Undecided → Low
Changed in xubuntu-docs (Ubuntu Maverick):
importance: Undecided → Low
Revision history for this message
Book 'em Dano (heymrdjd) wrote :

fix committed to revision 276 in lucid

Changed in xubuntu-docs (Ubuntu Lucid):
assignee: nobody → Book 'em Dano (heymrdjd)
status: New → Fix Committed
Revision history for this message
Book 'em Dano (heymrdjd) wrote :

fix committed to revision 242 in maverick

Changed in xubuntu-docs (Ubuntu Maverick):
assignee: nobody → Book 'em Dano (heymrdjd)
status: New → 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!

tags: added: verification-needed
Revision history for this message
Charlie Kravetz (cjkgeek) wrote :

Verified the xubuntu-docs are now correct. This chapter has been removed. I used a fresh installation of Xubuntu 10.04.1 in VirtualBox, fully updated before enabling proposed. Thanks 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.