← Back to team overview

documentation-packages team mailing list archive

[Bug 1686267] [NEW] please move ubuntu-help/ to gnome-help/

 

Public bug reported:

For Ubuntu 17.04 and earlier, we patched several (but not all) GNOME
apps to show help:ubuntu-help when run in Unity but still show help
:gnome-help when run in GNOME.

That won't work anymore with 17.10.

Test Case
---------
You can see this by installing gnome-shell then logging into GNOME. (It's probably easiest to choose lightdm if asked unless you install ubuntu-gnome-desktop because of LP: #1686257 )

Open the Help app. It should display either Ubuntu's Help or GNOME's
Help but it instead loads the All Help page because it can't find help
:gnome-help.

Easy Suggested Fix
------------------
bzr mv ubuntu-help gnome-help

Be sure to set Conflicts: gnome-user-guide

Then we probably need to change all the places that point to help
:ubuntu-help to point to help:gnome-help unless someone really wants to
maintain a Unity Help Guide.

Alternate Suggested Fix
-----------------------
We could just install gnome-user-guide instead of ubuntu-docs.

Depending on how much customization is wanted, you could fork gnome-
user-guide later.

And update help:ubuntu-help links to help:gnome-help like in the
previous fix.

Later
----
I think we'll eventually want a transitional package once we figure out what package name we're going to stick with.

** Affects: ubuntu-docs (Ubuntu)
     Importance: High
         Status: New

-- 
You received this bug notification because you are a member of
Documentation Packages, which is subscribed to ubuntu-docs in Ubuntu.
https://bugs.launchpad.net/bugs/1686267

Title:
  please move ubuntu-help/ to gnome-help/

Status in ubuntu-docs package in Ubuntu:
  New

Bug description:
  For Ubuntu 17.04 and earlier, we patched several (but not all) GNOME
  apps to show help:ubuntu-help when run in Unity but still show help
  :gnome-help when run in GNOME.

  That won't work anymore with 17.10.

  Test Case
  ---------
  You can see this by installing gnome-shell then logging into GNOME. (It's probably easiest to choose lightdm if asked unless you install ubuntu-gnome-desktop because of LP: #1686257 )

  Open the Help app. It should display either Ubuntu's Help or GNOME's
  Help but it instead loads the All Help page because it can't find help
  :gnome-help.

  Easy Suggested Fix
  ------------------
  bzr mv ubuntu-help gnome-help

  Be sure to set Conflicts: gnome-user-guide

  Then we probably need to change all the places that point to help
  :ubuntu-help to point to help:gnome-help unless someone really wants
  to maintain a Unity Help Guide.

  Alternate Suggested Fix
  -----------------------
  We could just install gnome-user-guide instead of ubuntu-docs.

  Depending on how much customization is wanted, you could fork gnome-
  user-guide later.

  And update help:ubuntu-help links to help:gnome-help like in the
  previous fix.

  Later
  ----
  I think we'll eventually want a transitional package once we figure out what package name we're going to stick with.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/ubuntu-docs/+bug/1686267/+subscriptions


Follow ups