hadoop-common-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Doug Cutting (JIRA)" <j...@apache.org>
Subject [jira] Commented: (HADOOP-1307) Documentation & classification of various configuration knobs
Date Mon, 30 Apr 2007 20:01:15 GMT

    [ https://issues.apache.org/jira/browse/HADOOP-1307?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12492772
] 

Doug Cutting commented on HADOOP-1307:
--------------------------------------

We already auto-generate HTML documenting all parameters.

http://lucene.apache.org/hadoop/hadoop-default.html

This is linked to from the javadoc.  E.g.:

http://lucene.apache.org/hadoop/api/overview-summary.html#overview_description

This could be more attractively formatted, and we could perhaps divide things into different
categories (client, server, user, expert, etc.), but I'd rather keep generating such documentation
from XML source if possible, so that it stays in sync.

The stylesheet that generates this table is in conf/configuration.xsl.


> Documentation & classification of various configuration knobs
> -------------------------------------------------------------
>
>                 Key: HADOOP-1307
>                 URL: https://issues.apache.org/jira/browse/HADOOP-1307
>             Project: Hadoop
>          Issue Type: Wish
>          Components: documentation
>            Reporter: Arun C Murthy
>
> Given the ever-increasing number of configuration knobs for both dfs and mapred, it would
be very useful in the long run to start and maintain up-to-date information (on the hadoop-wiki?)
for these. While we are at it, it could be well worth the time to classify each as USER (must
be overridden by user e.g. mapred.input/output.dir), BEGINNER, INTERMEDIATE, EXPERT (see HADOOP-1304)
so as to clearly demarcate them.
> Thoughts?

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


Mime
View raw message