hadoop-mapreduce-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Tom White (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (MAPREDUCE-4282) Convert Forrest docs to APT
Date Thu, 27 Sep 2012 10:52:08 GMT

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

Tom White commented on MAPREDUCE-4282:
--------------------------------------

Thanks for looking at this Eli. I tried to build the site using

{noformat}
mvn clean site; mvn -o site:stage -DstagingDirectory=/tmp/hadoop-site
{noformat}

but I got

{noformat}
Error during page generation: Files 'apt/index.apt.vm' clashes with existing '/Users/tom/workspace/hadoop-trunk/hadoop-project/src/site/apt/index.apt'.
{noformat}

The index.apt file contains documentation about distcp, so it should be renamed or merged
with distcp.apt. When I fixed that problem the build succeeded but the rendering of the files
looked wrong - it just had the raw markup.

I noticed that you put all the files at the top-level rather than in modules (Common, HDFS,
MapReduce). It probably makes sense to split them up more (see HADOOP-8860), although the
links get a bit more complex in that case due to the way that Maven uses the POM hierarchy
to create the structure.
                
> Convert Forrest docs to APT
> ---------------------------
>
>                 Key: MAPREDUCE-4282
>                 URL: https://issues.apache.org/jira/browse/MAPREDUCE-4282
>             Project: Hadoop Map/Reduce
>          Issue Type: Task
>    Affects Versions: 2.0.0-alpha
>            Reporter: Eli Collins
>            Assignee: Eli Reisman
>              Labels: newbie
>         Attachments: MAPREDUCE-4282-1.patch, MAPREDUCE-4282-2.patch
>
>
> MR side of HADOOP-8427. Not all of the old forrest docs in src/documentation/content/xdocs
have been converted over to APT yet, let's do that and remove the forrest docs.
>  

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Mime
View raw message