[ 
https://issues.apache.org/jira/browse/MAPREDUCE-6072?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14149767#comment-14149767
 ] 

Allen Wittenauer commented on MAPREDUCE-6072:
---------------------------------------------

I'm of mixed feelings on this patch.

While it is certainly desirable to point people to the web docs for 
installation, specifically to current is tricky because in 
the case of an incompatible change, those docs may be wrong.

An alternative idea:  Just remove the file.

I know! Crazy idea!  But bear with me:  INSTALL inside of the 
hadoop-mapreduce-project tree is completely the wrong place for this 
information.  The other trees don't have similar docs.  We also tell people how 
to build the documentation inside BUILDING.txt. Users are going to see that 
first. So let's just remove and solve the problem.

There probably should be a pointer inside BUILDING.txt that says "Look for 
these HTML files, after you built the docs" or something.

> Update INSTALL document
> -----------------------
>
>                 Key: MAPREDUCE-6072
>                 URL: https://issues.apache.org/jira/browse/MAPREDUCE-6072
>             Project: Hadoop Map/Reduce
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 2.6.0
>            Reporter: Akira AJISAKA
>            Assignee: Akira AJISAKA
>            Priority: Minor
>              Labels: newbie
>         Attachments: MAPREDUCE-6072.2.patch, MAPREDUCE-6072.patch
>
>
> "./hadoop-mapreduce-project/INSTALL" has become stale. The document shows
> * svn as SCM, now we use git
> * ant to compile hadoop-mapreduce-examples
> The document should be updated to link BUILDING.txt and web docs.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Reply via email to