Bug 1016307

Summary: Eng. review of Installation Guide
Product: [JBoss] JBoss Data Virtualization 6 Reporter: Van Halbert <vhalbert>
Component: DocumentationAssignee: David Le Sage <dlesage>
Status: CLOSED CURRENTRELEASE QA Contact: Filip Nguyen <fnguyen>
Severity: high Docs Contact:
Priority: unspecified    
Version: 6.0.0CC: atangrin, fnguyen, vhalbert
Target Milestone: GAKeywords: Documentation
Target Release: 6.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2014-02-04 01:47:51 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:

Comment 3 Filip Nguyen 2013-12-04 15:46:07 UTC
This should not be ON_QA yet, as it is pending Van's response.

Comment 4 Filip Nguyen 2013-12-04 15:47:20 UTC
Uff I might have misunderstood the status.

Comment 6 belong 2013-12-12 00:41:18 UTC
Filip,

Content Services management requested that we produce both the Getting Started Guide and Installation Guide for consistency between our products.

So, to address Van's original concerns:

> - There is a whole section on installing and configuring Maven... why?  Shouldn't that be in Gettting Started Guide, because that's what depends on it.

We have put the Maven documentation in the Getting Started Guide with the quickstarts.

> - This guide has the same quick starts.

Quickstarts are in the Getting Started Guide only.

> - There's other duplication between "Getting Started" doc and the "Installation Guide" doc. Should we consider whether having the GSG refer to installation guide?

We have reduced duplication of content as much as it makes sense.

Regards,
Ben

Comment 7 belong 2013-12-12 00:49:01 UTC
(We have also stated in the abstract, to refer to the Installation Guide for more information and installation options.)

Comment 8 belong 2013-12-12 02:20:42 UTC
Filip,

Please verify that Van's original concerns have been addressed (based on my notes in Comment 6 & Comment 7). I will open a new bug to verify the actual splitting of content between the two guides.

Cheers,
Ben