[
https://issues.apache.org/jira/browse/HADOOP-1917?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12538660
]
Nigel Daley commented on HADOOP-1917:
-------------------------------------
Comments (nits) on setup.xml
replace <strong> with <code> in a number of places (environment variables,
commands, etc)
"Installing a hadoop cluster is just a simple step on ensuring that the
software is distributed to all the machines in the cluster." -> "Installing a
Hadoop cluster typically involves unpacking the software on all the machines in
the cluster."
"found in" -> "found in the"
"the hadoop scripts provided, found in the" -> "the Hadoop scripts found in the"
"the hadoop-daemons" -> "the Hadoop daemons"
"Environment of Hadoop Daemons" -> "Setting the Hadoop Daemons Environment"
"necessary configuration parameters" -> "necessary <em>configuration
parameters</em>"
"Other possible knobs to tweak are:" -> "Other useful configuration parameters
to customize are:"
State whether or not HADOOP_LOG_DIR already has to exist or whether it will be
created if it doesn't.
Do you need to define somewhere what "Hadoop daemons" are?
"machines act as both" -> "machines act as both a"
"i.e. the" -> "and are referred to as"
"Hadoop Daemons' logs" -> "Hadoop daemons logging configuration"
"Bootup Hadoop" -> "Startup Hadoop"
"is the small matter of" -> "involves"
> Need configuration guides for Hadoop
> ------------------------------------
>
> Key: HADOOP-1917
> URL: https://issues.apache.org/jira/browse/HADOOP-1917
> Project: Hadoop
> Issue Type: Improvement
> Components: conf
> Affects Versions: 0.14.1
> Reporter: Sameer Paranjpye
> Assignee: Arun C Murthy
> Priority: Critical
> Fix For: 0.16.0
>
> Attachments: HADOOP-1917_1_20071025.patch
>
>
> We've recently had a spate of questions on the users list regarding features
> such as rack-awareness, the trash can etc. which are not clearly documented
> from a user/admins perspective. There is some Javadoc present but most of the
> "documentation" exists either in JIRA or in the default config files
> themselves.
> We should generate top down configuration and use guides for map/reduce and
> HDFS. These should probably be in forest and accessible from the project
> website (Javadoc isn't always approachable to our non-programmer audience).
> Committers should look for user documentation before accepting patches.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
