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

[Frank Heimes]

** Description changed:

  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
- It includes two further child documents covering:
-  - step-by-step instructions on howto setup Ubuntu on z in an LPAR:
-    https://wiki.ubuntu.com/S390X/Installation%20In%20LPAR
-  - step-by-step instructions on howto setup Ubuntu on z as z/VM guest:
-    https://wiki.ubuntu.com/S390X/Installation%20In%20zVM
-  - step-by-step instructions on howto setup Ubuntu on z as KVM for IBM z Systems:
-    https://wiki.ubuntu.com/S390X/Installation%20In%20zKVM
  
- Please update the official Ubuntu 16.04 installation guide available here:
- https://help.ubuntu.com/16.04/installation-guide/
- especially the s390x specific parts with the revised version that is temporarily available from that wiki:
- https://wiki.ubuntu.com/S390X/InstallationGuide
  
- It will also be helpful if the links at the Installation Guide landing
- page that points to the s390x version(s) can be temporarily replaced by
- the link to the wiki - just until the update and merge is completed.
+ 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.

** Branch linked: lp:~frank-heimes/installation-guide/ubuntu-18.04
-s390x-appendices_and_more

** Also affects: ubuntu-z-systems
   Importance: Undecided
       Status: New

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

** Changed in: ubuntu-z-systems
   Importance: Undecided => Medium

** Changed in: ubuntu-z-systems
     Assignee: (unassigned) => Frank Heimes (frank-heimes)

-- 
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:
  In Progress
Status in installation-guide package in Ubuntu:
  In Progress

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