hadoop-common-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Glen Mazza (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (HADOOP-9197) Some little confusion in official documentation
Date Mon, 14 Jan 2013 17:18:15 GMT

    [ 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

Mime
View raw message