hadoop-common-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Jakob Homan (JIRA)" <j...@apache.org>
Subject [jira] Commented: (HADOOP-7069) Replace forrest with supported framework
Date Wed, 22 Dec 2010 02:58:03 GMT

    [ https://issues.apache.org/jira/browse/HADOOP-7069?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12974026#action_12974026
] 

Jakob Homan commented on HADOOP-7069:
-------------------------------------

It'd be great if we can get forrest working with Java 6, sure thing.  But given the  lack
of activity in the Forrest project over the past nearly four years, it's probably prudent
to move sooner than later.  I played with textile a bit the other night and actually quite
liked it.  It's worth comparing it (and others) against maven's site generation.  I would
tend toward textile (or something like it) rather than whatever Maven happens to provide,
on the assumption that a stand-alone tool would provide more features and flexibility.  

The mavenization effort is a huge amount of work that would be great to get done, but it's
probably too big (x3 - thanks project split!) to be done without a pressing need from one
of the commercial interests contributing to Hadoop.  It would be great to know if that's being
planned.  I'm not aware that it is.

> Replace forrest with supported framework
> ----------------------------------------
>
>                 Key: HADOOP-7069
>                 URL: https://issues.apache.org/jira/browse/HADOOP-7069
>             Project: Hadoop Common
>          Issue Type: Improvement
>          Components: documentation
>            Reporter: Jakob Homan
>             Fix For: 0.23.0
>
>
> It's time to burn down the forrest.  Apache forrest, which is used to generate the documentation
for all three subprojects, has not had a release in several years (0.8, the version we use
was released April 18, 2007), and requires JDK5, which was EOL'ed in November 2009.  Since
it doesn't seem likely Forrest will be developed any more, and JDK5 is not shipped with recent
OSX versions, or included by default in most linux distros, we should look to find a new documentation
system and convert the current docs to it.

-- 
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