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

Reply via email to