Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1171520

Summary: Enhance documentation for JBoss JON in Admin and Config guide.
Product: [JBoss] JBoss Fuse Service Works 6 Reporter: Nichola Moore <nmoore>
Component: DocumentationAssignee: Nichola Moore <nmoore>
Status: CLOSED CURRENTRELEASE QA Contact:
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 6.0.0CC: belong, soa-p-jira
Target Milestone: ---   
Target Release: 6.0.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2015-07-23 02:55:41 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:
Bug Depends On:    
Bug Blocks: 1160968    

Description Nichola Moore 2014-12-08 00:02:20 UTC
Check over documentation for JBoss JON in the Admin and Config Guide and see if it needs enhancing. If it does, do it.

Comment 1 belong 2014-12-12 02:20:05 UTC
*** Bug 1146351 has been marked as a duplicate of this bug. ***

Comment 2 belong 2014-12-12 02:21:51 UTC
"Consider adding screenshots as per Jorge Morales' email (to Ben dated 08/26/2014)." <-- Comment from duplicate Bug 1146351.

Comment 5 belong 2015-01-16 01:42:44 UTC
This is a great improvement, Nichola! Thank you for your persistence with working out how to actually get these things working together and putting together a simplified summary of the steps required.

Suggestions for improvement:

Section 'JBoss Operations Network and JBoss Fuse Service Works':

 - Change title to 'Installing JBoss Operations Network for JBoss Fuse Service Works'

 - For the instruction to install JON, the link to the installation guide is currently pointing to 2.3 - should be 3.2. Also, can we be more specific about which sections of that guide to refer to at this point - i.e., 'Setting up Databases' and 'Installing the JBoss ON Server'? Otherwise, readers are presented with the whole guide which is overwhelming.

 - For the instructions to install the plug-in pack, again the link is incorrect (pointing to 2.3 docs).

 - Note re links: Can those two lengthy URLs be hidden by some nice text?

 - "Follow the configuration instructions in the JBoss Operations Network Installation Guide" - What does this mean? Is there anything specific I am supposed to do here?

Let me know if you would like any clarification.

Cheers,
Ben

Comment 7 belong 2015-02-10 04:50:21 UTC
Setting back to assigned. Waiting on final changes.

Comment 9 belong 2015-07-23 02:55:41 UTC
Resolved and tracked in linked JIRA.