Bug 1043355

Summary:	Clarify patching and upgrading differences and section organization.
Product:	[JBoss] JBoss Enterprise Application Platform 6	Reporter:	Lucas Costi <lcosti>
Component:	Documentation	Assignee:	Lucas Costi <lcosti>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Russell Dickenson <rdickens>
Severity:	high	Docs Contact:
Priority:	unspecified
Version:	6.2.0	CC:	jmartisk, pkremens, sgilda, smumford
Target Milestone:	ER5	Keywords:	Documentation
Target Release:	EAP 6.3.0
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:	Build Name: 14873, Installation Guide-6.2-1 Build Date: 07-11-2013 09:21:49 Topic ID: 24385-550310 [Specified]
Last Closed:	2014-06-28 15:31:54 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Bug Depends On:	1039541
Bug Blocks:

Description Lucas Costi 2013-12-16 05:13:28 UTC

Title: About Patches and Upgrades

Describe the issue:

There has been some confusion as to the 'See Also' links at the end of this topic (specified in the CS Map). It may be better to clarify the differences between patches and upgrades a bit better, especially to remove the "requires a different process" part.

Comment 1 Lucas Costi 2014-01-29 05:43:42 UTC

After IRC conversation with Misty, other possible improvements to the patching and upgrading section:

* Change title of '5.2. Patch Installation', to something like "Applying patches"

* Promote the procedures more in 5.2, by moving '5.2.2. Subscribe to Patch Mailing Lists' to the end of the section.

* Change title of '5.3. Upgrade Instructions' to something like "Upgrade to the next version"

* Review and rework contents of 5.2.1. About Patching Mechanisms

Comment 2 Lucas Costi 2014-02-17 00:09:48 UTC

Added depends on bug for patching terminology update.

Comment 3 Lucas Costi 2014-02-21 05:41:04 UTC

Changes made:

* "About Patching Mechanisms" (topic 13441) has been rearranged and updated (revision 591206).

* "Subscribe to Patch Mailing Lists" has been moved to the bottom of the patching and Upgrading section.

* "patch installation" section renamed to "Patching JBoss EAP 6"

* "Upgrade Instructions" section renamed to "Upgrading JBoss EAP 6"

Will need to review the changes before pushing to QA.

Comment 4 Lucas Costi 2014-05-19 01:28:03 UTC

Last change was made to the topic titles to make them clearer:

Install Patches in Zip Form -> Patching a Zip/Installer Installation

Install Patches in RPM Form -> Patching an RPM Installation

Changes can be previewed here:

http://docbuilder.usersys.redhat.com/22510/#chap-Patching_and_Upgrading_JBoss_EAP_6

Comment 5 sgilda 2014-05-21 19:09:45 UTC

This can be verified here:
http://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/Installation_Guide/index.html#chap-Patching_and_Upgrading_JBoss_EAP_6

Comment 6 Jan Martiska 2014-05-29 12:03:17 UTC

Verified in JBoss_Enterprise_Application_Platform-Installation_Guide-6.3-en-US-6.3.0-15