[ 
https://issues.apache.org/jira/browse/HADOOP-7085?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Eli Collins updated HADOOP-7085:
--------------------------------

    Summary: Documentation uses urls with "current"  (was: Cluster setup docs 
link to the wrong default config files)

On trunk a lot of the documentation uses the current symlink, so generated docs 
for an old release contain pointers to new documentation that the release does 
not support. 

I think these links should be relative links, looks like they're using absolute 
urls because they point to generated files and forrest will complain about 
broken links if relative links are specified and the target files do not exist 
when forrest is run. One fix is to create empty xml files (eg core-default.xml 
etc) in the docs that are later over-written. This way forrest won't complain 
about the relative link (and the link will point to the appropriate document).

> Documentation uses urls with "current"
> --------------------------------------
>
>                 Key: HADOOP-7085
>                 URL: https://issues.apache.org/jira/browse/HADOOP-7085
>             Project: Hadoop Common
>          Issue Type: Bug
>          Components: documentation
>            Reporter: Eli Collins
>            Priority: Minor
>
> The mapred and hdfs default links on the following page are broken. Looking 
> into the cause, the links always point to the current docs so old generated 
> docs have the wrong pointers (they should point to docs/<release> instead of 
> docs/current). This is because cluster_setup.xml uses site.xml which defines 
> references to the docs using http://hadoop.apache.org/core/docs/current.
> http://hadoop.apache.org/common/docs/r0.20.2/cluster_setup.html

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

Reply via email to