Bug 809968 - Docs: Create narrative output
Summary: Docs: Create narrative output
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: JBoss Data Grid 6
Classification: JBoss
Component: Documentation
Version: 6.0.0
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: ---
: 6.0.0
Assignee: Misha H. Ali
QA Contact: prabhat jha
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2012-04-04 18:47 UTC by mark yarborough
Modified: 2012-08-15 16:44 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2012-04-19 02:14:15 UTC
Type: Bug
Embargoed:


Attachments (Terms of Use)

Description mark yarborough 2012-04-04 18:47:14 UTC
As of JDG6 Beta1 in April 2012, QE indicated that the topic-based 
navigation was very confusing. This is an important problem to fix
before GA, and it may take several tries due to the fragmented nature
of the topic-based approach and the subjective perception of "Good
navigation." Asking Misha to incorporate pre-Bz input from Pete Muir,
Alan Santos, Prabhat Jha and others into this bug as needed. Not sure
how to best review the result, but we should do it earlier than 6.0.0.CR1
and should probably involve the field as well (SA's and such). Please ping
PM or PGM as needed for help on setting up field reviews. How are other 
products (eg. EAP) reviewing the topic navigation? Thanks.

Comment 1 Misha H. Ali 2012-04-04 19:53:11 UTC
Discussion and resulting plans have determined that the current topic based format will not be used for GA. Instead, the same (and additional) content is to be mapped into multiple narrative books, namely:

1. Getting Started Guide
2. Administration and Configuration Guide
3. Developers Guide

The topic based content will only be used for the JDG beta release.

Comment 2 Misha H. Ali 2012-04-04 21:52:14 UTC
Additional decision, a post beta documentation release will occur (timeline undetermined currently but safe to say 1-2 weeks after beta release) where all topics included in beta documentation will be factored into a narrative document. Said narrative document will be released as an addition to the beta documentation suite.

Comment 5 prabhat jha 2012-04-16 01:13:49 UTC
Misha, I definitely like this better. I did not go through contents in details since I am assuming these are same from topic based approached that we went through in details.

Comment 6 prabhat jha 2012-04-16 01:23:46 UTC
It's good for beta. For GA, we would need more contents.


Note You need to log in before you can comment on or make changes to this bug.