[jira] Commented: (HIVE-81) Make forrest docs for Hive web site along the lines of http://hadoop.apache.org/core/

["Joydeep Sen Sarma (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/HIVE-81?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12651243#action_12651243 ] 

Joydeep Sen Sarma commented on HIVE-81:
---------------------------------------

Ashish and I talked about this earlier this week.

Another option (simpler than forrest) seems to be apt (wiki like). We can compile apt files via Maven. See:

http://maven.apache.org/guides/mini/guide-site.html

and 

http://maven.apache.org/doxia/references/apt-format.html

thoughts?

one thing we noticed was that Google does not actually show up hadoop official documentation on search queries. Javadocs rank really high (probably because of all the hyper links and i have personally found package headers to be really good documentation for hadoop (but on the other hand - hadoop does not have much declarative stuff). (perhaps this is a second order problem - but i am concerned that the documentation we create painstakingly will be the one that users actually refer to)

> Make forrest docs for Hive web site along the lines of http://hadoop.apache.org/core/
> -------------------------------------------------------------------------------------
>
>                 Key: HIVE-81
>                 URL: https://issues.apache.org/jira/browse/HIVE-81
>             Project: Hadoop Hive
>          Issue Type: New Feature
>            Reporter: Jeff Hammerbacher
>         Attachments: HIVE-81.patch
>
>
> Hive should ship with documentation, like Hadoop, instead of using the wiki as the official documentation repository. To get there, we'll need a set of xml files to grind through forrest, if we want to reuse the same mechanisms as the other sites.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.