[ 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