[
https://issues.apache.org/jira/browse/HADOOP-9197?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13552896#comment-13552896
]
Glen Mazza commented on HADOOP-9197:
------------------------------------
I don't see the problem--who says the documentation for different versions of
Hadoop must be the same? That's as nonsensical as saying the source code has
to be identical for different versions. What's the purpose of versions if you
can't improve the source code and documentation over time? It doesn't matter
that version 1.0 says "X", version 2.0 says "Y', and version 3.0 says "Z"--it
only matters if version 3.0's Z is incorrect. Jason needs to pick a single
version of Hadoop he wishes to work on and focus on that version's
documentation and ignore the others. If he finds bugs in that version's docs
then to submit a JIRA over them--not a JIRA because the documentation, like the
source code, has changed across versions.
> Some little confusion in official documentation
> -----------------------------------------------
>
> Key: HADOOP-9197
> URL: https://issues.apache.org/jira/browse/HADOOP-9197
> Project: Hadoop Common
> Issue Type: Improvement
> Components: documentation
> Reporter: Jason Lee
> Priority: Trivial
> Original Estimate: 336h
> Remaining Estimate: 336h
>
> I am just a newbie to Hadoop. recently i self-study hadoop. when i reading
> the official documentations, i find that them is a little confusion by
> beginners like me. for example, look at the documents about HDFS shell guide:
> In 0.17, the prefix of HDFS shell is hadoop dfs:
> http://hadoop.apache.org/docs/r0.17.2/hdfs_shell.html
> In 0.19, the prefix of HDFS shell is hadoop fs:
> http://hadoop.apache.org/docs/r0.19.1/hdfs_shell.html#lsr
> In 1.0.4,the prefix of HDFS shell is hdfs dfs:
> http://hadoop.apache.org/docs/r1.0.4/file_system_shell.html#ls
> As a beginner, i think reading them is suffering.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira
