[Bug 1575236] Re: adjust the s390x parts of the install guide

[Frank Heimes]

** Changed in: installation-guide (Ubuntu)
       Status: In Progress => Fix Committed

** Changed in: ubuntu-z-systems
       Status: In Progress => Fix Committed

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to installation-guide in Ubuntu.
https://bugs.launchpad.net/bugs/1575236

Title:
  adjust the s390x parts of the install guide

Status in Ubuntu on IBM z Systems:
  Fix Committed
Status in installation-guide package in Ubuntu:
  Fix Committed
Status in installation-guide source package in Bionic:
  Fix Committed

Bug description:
  IBM and also some early adopter customers complaint about the official Ubuntu 16.04 installation guide for s390x (IBM System z):
  https://help.ubuntu.com/16.04/installation-guide/
  mentioning that:
  - it contains partly outdated information and links
  - that there is not enough s390x / IBM z Systems focus
  - that the naming is not correct
  - that it includes information that is not relevant to s390x

  Due to these complaints and because of the urgency I created an adjusted and revised version of the install guide with special s390x focus and transformed it (for convenience reasons) to a wiki.
  It is located here: https://wiki.ubuntu.com/S390X/InstallationGuide

  
  SRU Request:
  ============

  [Impact]

   * Updated the desired changes of the inst. guide regarding naming
  conventions etc.

   * and s390x specific details

   * Because 18.04.1 is the main upgrade target it's important to have
  it in place with 16.04.1

   * The changes on the doc not only updated the outdated content ...

   * ... but also added new functions and technology (like FCP) that was
  added to the platform since the last update

  [Test Case]

   * Open the updated doc - as either html, PS, PDF or txt ...

   * and compare the modified and new content with the current
  functionality the platform provides

  [Regression Potential]

   * The regression potential is low because most changes are platform
  (s390x) specific

   * However, since it's written in docbook with several conditional
  statements changes on one platform may cause an impact to other, too.

   * For verification reasons I created the guide after my changes not
  only for s390x, but also for other platforms...

   * ... and even found two issues that I fixed (nested use of xml
  elements, that cause issues while creating PDF, even if HTML creation
  still worked fine ...)

   * No impact is expected on an Ubuntu installation itself - since it's
  documentation only.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu-z-systems/+bug/1575236/+subscriptions