Bug 1250614
Summary: | [Doc Bug Fix] Changes from bug 1236119 should also appear in Installation Guide, chapter 3.3 | ||
---|---|---|---|
Product: | [JBoss] JBoss Enterprise Application Platform 6 | Reporter: | Ladislav Thon <lthon> |
Component: | Documentation | Assignee: | sgilda |
Status: | CLOSED CURRENTRELEASE | QA Contact: | Ladislav Thon <lthon> |
Severity: | unspecified | Docs Contact: | |
Priority: | unspecified | ||
Version: | 6.4.0 | CC: | eap-docs, lthon, sgilda, smumford, wfink |
Target Milestone: | post-GA | Keywords: | Documentation, EasyFix, Triaged |
Target Release: | EAP 6.4.3 | ||
Hardware: | Unspecified | ||
OS: | Unspecified | ||
Whiteboard: | |||
Fixed In Version: | Doc Type: | Bug Fix | |
Doc Text: | Story Points: | --- | |
Clone Of: | Environment: | ||
Last Closed: | 2015-10-20 12:46:02 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: | |
Embargoed: |
Description
Ladislav Thon
2015-08-05 14:58:31 UTC
I would not add this here (two places to maintain) I would vote for a introduction like this: If this installation replace a former version you might conside to upgrade. The migration guide will show aproaches for major/minor/micro updates The problem is that there are _already_ two places that compete with the same type of content. It makes sense to me to have this content available both in Install Guide and Migration Guide, but it doesn't make sense to me that the content is different. Some information is available only in the Install Guide, some only in the Migration Guide. AFAIK, documentation topics can be reused, so that the maintenance overhead doesn't increase. That would be my favorite solution. Hi Ladislav. You're correct in the assertion that we can reuse topics between books with minimal effort and maintenance overhead. Should all of Sande's new content (Migration Guide Chapter 2.4: "About Migrations and Upgrades" [44602]) be included, or only a subset of it? Also, Sande, should we need to, would you be willing to work with conditional tagging in the Migration Guide content? Hi Scott, I'd be happy to. I'll grab this bug. I took a quick look at chapter 2.4 About Migrations and Upgrades in the Migration Guide again and I think that: - the Major Upgrades part probably doesn't need to be in the Installation Guide - the Minor Updates part directly competes with chapter 3.3. Upgrading JBoss EAP 6 of the Installation Guide (mostly with 3.3.1 and 3.3.2) - the Cumulative Patches part seems to summarize chapters 3.1. About Patches and Upgrades and 3.2. Patching JBoss EAP 6 and so doesn't need to be in the Installation Guide Which, to me, results in the need to somehow merge the "Minor Updates" part of chapter 2.4 About Migrations and Upgrades in the Migration Guide with chapter 3.3. Upgrading JBoss EAP 6 of the Installation Guide. They both contain important information that is missing from the other part. Thanks Ladislav. I will move this to ON_QA after the next build. Thanks Wolf! |