Bug 1695867 - [Docs] Revise Chapter 2.2. Independent mode for improved clarity and completeness
Summary: [Docs] Revise Chapter 2.2. Independent mode for improved clarity and complete...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat Storage
Component: doc-Container_Native_Storage_with_OpenShift
Version: ocs-3.11
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: OCS 3.11.z Batch Update 3
Assignee: Chandrakanth Pai
QA Contact: RamaKasturi
URL:
Whiteboard:
Depends On:
Blocks: 1694089
TreeView+ depends on / blocked
 
Reported: 2019-04-03 20:07 UTC by khartsoe@redhat.com
Modified: 2019-07-22 13:29 UTC (History)
10 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2019-07-22 13:29:32 UTC
Embargoed:


Attachments (Terms of Use)

Description khartsoe@redhat.com 2019-04-03 20:07:15 UTC
Description of problem:
Storage Consulting has raised concerns about the clarity and completeness of "2.2. Independent mode". Ask is to revise this section for improved clarity and make sure sections contains complete information (i.e. at-rest encryption is not mentioned).

Version-Release number of selected component (if applicable):
https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/3.11/html/deployment_guide/chap-documentation-introduction_crs_for_ocp

How reproducible:


Steps to Reproduce:
1.
2.
3.

Actual results:


Expected results:


Additional info:

Comment 2 Wolfgang Schulze 2019-04-03 21:05:58 UTC
The main criticism was that this section is confusing. In the very first sentence, it says that independent mode and converged mode provide the same functionality, which is not true. There are several things that _only_ independent mode will be able to provide. 

If somebody is facing the decision between independent mode and converged, give them guidance what the pros and cons are of each one.

Comment 4 RamaKasturi 2019-04-05 13:05:58 UTC
Hello Anjana,

   I do not see a devel_ack for this. I will be able to provide qa_ack once dev_ack is in place.


Thanks
kasturi

Comment 5 Anjana Suparna Sriram 2019-04-08 11:30:13 UTC
Hi Kasturi,

Provided the devel_ack for this bug.

Regards,
Anjana

Comment 6 RamaKasturi 2019-04-08 13:45:53 UTC
Hello Anjana,

   Do we have the list of changes which are needed in this section ? If yes, can you please provide the list here ?

Thanks
kasturi

Comment 8 RamaKasturi 2019-04-08 18:08:23 UTC
Hello ken,

   I think it would be good to finalize what all we document before we ack it in for 3.11.3, IMO.

Thanks
kasturi

Comment 9 Wolfgang Schulze 2019-04-08 19:25:20 UTC
Excuse my ignorance, but who is actually on the hook for (re)writing the text?

Regards,
Wolfgang

Comment 11 RamaKasturi 2019-04-09 04:54:06 UTC
Thanks Ken for the explaining.

As per comment 10 the section is going to be revised to be clearer explaining the differences between independent from converged and explains the advantage of independent mode.

Providing qa_ack .


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