[
https://issues.apache.org/jira/browse/WHIRR-19?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12876801#action_12876801
]
Tom White commented on WHIRR-19:
--------------------------------
> Cassandra is recently out of incubation, they seem to have 2 static pages
> (home & download) and the rest of their docs are all wiki/javadoc based.
They don't seem to have any documentation in the release artifacts either.
That's another thing to consider - how to version documentation for a
particular release (and whether it has to go into the tarball).
> I'm not particularly fond of forrest after using it for hadoop/zookeeper. Any
> interest in using sphinx? (used to generate the docs for python).
> http://sphinx.pocoo.org/ (their site is itself generated with sphinx)
I'm not a big Forrest fan either. The Java 5 thing is annoying, and I found it
non-trivial to change the layout (e.g. to add a Google Analytics code). I
haven't used Sphinx. AsciiDoc is yet another option I've used:
http://www.methods.co.nz/asciidoc/.
> Create project website
> ----------------------
>
> Key: WHIRR-19
> URL: https://issues.apache.org/jira/browse/WHIRR-19
> Project: Whirr
> Issue Type: Task
> Components: documentation
> Reporter: Tom White
> Priority: Blocker
> Fix For: 0.1.0
>
>
> Whirr needs a website at http://incubator.apache.org/whirr.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
