[ 
https://issues.apache.org/jira/browse/HDFS-2733?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13201425#comment-13201425
 ] 

Stephen Barlow commented on HDFS-2733:
--------------------------------------

• Consider simplifying the first sentence describing each of the 8 
configuration parameters, and have it on a separate line from any additional 
discussion to improve scanability. Short noun phrases are better than 
imperatives for introducing parameters (e.g., for #3, "Similarly to rpc-address 
above, set the addresses for both NameNodes' HTTP servers to listen on." 
becomes "The addresses for both NameNodes' HTTP servers to listen on.") Also 
regarding #3, 'exaple' -> 'example'

• Unless config parameters must be set in a particular order, consider 
switching to an unordered list (even though I just referenced an item by number)

• Wherever 'once' means 'after', use 'after' (reduces ambiguity)
                
> Document HA configuration and CLI
> ---------------------------------
>
>                 Key: HDFS-2733
>                 URL: https://issues.apache.org/jira/browse/HDFS-2733
>             Project: Hadoop HDFS
>          Issue Type: Sub-task
>          Components: documentation, ha
>    Affects Versions: HA branch (HDFS-1623)
>            Reporter: Eli Collins
>            Assignee: Aaron T. Myers
>         Attachments: HDFS-2733-HDFS-1623.patch, HDFS-2733-HDFS-1623.patch, 
> HDFS-2733-HDFS-1623.patch, HDFSHighAvailability.html, 
> HDFSHighAvailability.html, HDFSHighAvailability.html
>
>
> We need to document the configuration changes in HDFS-2231 and the new CLI 
> introduced by HADOOP-7774.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: 
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira


Reply via email to