doomleika created HADOOP-10396:
----------------------------------

             Summary: The 2.X official document is in sorry state.
                 Key: HADOOP-10396
                 URL: https://issues.apache.org/jira/browse/HADOOP-10396
             Project: Hadoop Common
          Issue Type: Bug
          Components: documentation
    Affects Versions: 2.2.0
            Reporter: doomleika
            Priority: Minor


Hello, I am new to Hadoop 2.X line and I found most of the document does 
poorly, hard to read, and misleading to a point it's doing more harm than good.

Example, most documents in http://hadoop.apache.org/docs/r2.2.0/ identify 
itself as 'Apache Hadoop 2.1.1-beta' instead of 'Apache Hadoop 2.2 release'

The first section building hadoop from source tells nothing about what package 
required to be built (jdk?g++?)

That's just tip of iceberg, that second page 'single cluster setup', that 
second section 'Mapreduce Tarball' says:
 'You should be able to obtain the MapReduce tarball from the release. If not, 
you should be able to create a tarball from the source.'

What it should do it put a like to hadoop download release link. let alone all 
that confusing test in section 3 'Setting up the environment' which did no 
explaination on what does all that do.

Lots of documents in release are ridden problems like this. Review is needed 
for those document or at least a warning about it may be outdated.





--
This message was sent by Atlassian JIRA
(v6.2#6252)

Reply via email to