[HADOOP-1917] Need configuration guides for Hadoop

• Type: Improvement
• Status: Closed
• Priority: Critical
• Resolution: Fixed
• Affects Version/s: 0.14.1
• Fix Version/s: 0.15.1
• Component/s: documentation
• Assignee: Arun Murthy
• Reporter: Sameer Paranjpye
• Created: 18/Sep/07 19:27
• Updated: 28/Nov/07 22:32
• Resolved: 13/Nov/07 09:09

Description

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.

Issue Links

• is related to: HDFS-295 Update the "how to configure HDFS" documentation to include new features
• is related to: HADOOP-2046 Documentation: improve mapred javadocs