You are viewing a plain text version of this content. The canonical link for it is here.
Posted to common-issues@hadoop.apache.org by "Akshay Nehe (Jira)" <ji...@apache.org> on 2020/03/02 20:37:00 UTC
[jira] [Updated] (HADOOP-16899) Update HdfsDesign.md to reduce
ambiguity
[ https://issues.apache.org/jira/browse/HADOOP-16899?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Akshay Nehe updated HADOOP-16899:
---------------------------------
Description:
A proposed update to [https://github.com/apache/hadoop/blob/trunk/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/HdfsDesign.md|http://example.com/] in the section "Replica Placement: The First Baby Steps" 4th paragraph, 2nd last line.
The sentence is leading to ambiguity of reader.
Considering the statement segmented in 3 parts by the commas:
# the first part talks about "one thirds of replicas";
# the second part talks about "two thirds of replicas"
# the third part talking about "the other third" is leading to ambiguity when one thirds and two thirds have already accounted for the whole.
Proposed solution:
Getting rid of the third part or rephrasing entire sentence to capture the overall essence of the sentence.
In other words, replacing
_One third of replicas are on one node, two thirds of replicas are on one rack, and the other third are evenly distributed across the remaining racks._
with
_One third of replicas are on one node, two thirds of replicas are on one rack._
Please suggest if any additional meaning is getting lost with this replacement.
was:
A proposed update to [https://github.com/apache/hadoop/blob/trunk/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/HdfsDesign.md|http://example.com] in the section "Replica Placement: The First Baby Steps" 4th paragraph, 2nd last line.
The sentence is leading to ambiguity of reader.
Proposed solution:
Getting rid of the third part of sentence (after 2nd comma) or rephrase entire sentence to capture the overall essence of the sentence.
In other words, replacing
_One third of replicas are on one node, two thirds of replicas are on one rack, and the other third are evenly distributed across the remaining racks._
with
_One third of replicas are on one node, two thirds of replicas are on one rack._
Please suggest if any additional meaning is getting lost with this replacement.
> Update HdfsDesign.md to reduce ambiguity
> ----------------------------------------
>
> Key: HADOOP-16899
> URL: https://issues.apache.org/jira/browse/HADOOP-16899
> Project: Hadoop Common
> Issue Type: Improvement
> Components: documentation
> Reporter: Akshay Nehe
> Priority: Minor
>
> A proposed update to [https://github.com/apache/hadoop/blob/trunk/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/HdfsDesign.md|http://example.com/] in the section "Replica Placement: The First Baby Steps" 4th paragraph, 2nd last line.
> The sentence is leading to ambiguity of reader.
> Considering the statement segmented in 3 parts by the commas:
> # the first part talks about "one thirds of replicas";
> # the second part talks about "two thirds of replicas"
> # the third part talking about "the other third" is leading to ambiguity when one thirds and two thirds have already accounted for the whole.
> Proposed solution:
> Getting rid of the third part or rephrasing entire sentence to capture the overall essence of the sentence.
> In other words, replacing
> _One third of replicas are on one node, two thirds of replicas are on one rack, and the other third are evenly distributed across the remaining racks._
> with
> _One third of replicas are on one node, two thirds of replicas are on one rack._
> Please suggest if any additional meaning is getting lost with this replacement.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: common-issues-unsubscribe@hadoop.apache.org
For additional commands, e-mail: common-issues-help@hadoop.apache.org