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 Mon, 20 Dec 2010 01:24:01 GMT

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

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

Both Whirr and ZooKeeper have recently looked at this issue and come to different conclusions:
* Whirr (WHIRR-19) went with maven site generation, but this seems out of reach until the
build is mavenized, which isn't likely to happen soon.
* ZooKeeper (ZOOKEEPER-925) went through the pain of trying to convert its existing forrest
docs and eventually chose textile (https://issues.apache.org/jira/browse/ZOOKEEPER-925?focusedCommentId=12971846&page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#action_12971846)

Perhaps we should take the benefit of Ben and Pat's toil and evaluate textile first, although
it seems to have its share of problems as well.

> 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