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