hadoop-hive-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Joydeep Sen Sarma (JIRA)" <j...@apache.org>
Subject [jira] Commented: (HIVE-81) Make forrest docs for Hive web site along the lines of http://hadoop.apache.org/core/
Date Thu, 27 Nov 2008 04:32:44 GMT

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


Mime
View raw message