hive-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Lefty Leverenz (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (HIVE-4994) Add WebHCat (Templeton) documentation to Hive wiki
Date Tue, 15 Oct 2013 05:28:42 GMT

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

Lefty Leverenz commented on HIVE-4994:
--------------------------------------

These topics have already been linked:  overviews, install, configure, CLI, DDL, data types,
authorization, and web (HWI & WebHCat, a tenuous connection).

These topics still need to be linked: 

* _dynamic partitions_ 
** HCatalog's [Dynamic Partitioning|https://cwiki.apache.org/confluence/display/Hive/HCatalog+DynamicPartitions]
** Hive Tutorial's [Dynamic-Partition Insert|https://cwiki.apache.org/confluence/display/Hive/Tutorial#Tutorial-DynamicPartitionInsert]
** Hive DML's [Dynamic Partition Inserts|https://cwiki.apache.org/confluence/display/Hive/LanguageManual+DML#LanguageManualDML-DynamicPartitionInserts]
** Hive design doc [Dynamic Partitions|https://cwiki.apache.org/confluence/display/Hive/DynamicPartitions]

* _error logs_
** Getting Started [Error Logs|https://cwiki.apache.org/confluence/display/Hive/GettingStarted#GettingStarted-ErrorLogs]
** HCatalog install's "Logging" -- nope, it's gone now
** WebHCat [Log Files|https://cwiki.apache.org/confluence/display/Hive/WebHCat+UsingWebHCat#WebHCatUsingWebHCat-LogFiles]
** also [HIVE-5528|https://issues.apache.org/jira/browse/HIVE-5528]: hive log file name in
local is ".log"

* _storage formats_ 
** HCatalog [Storage Formats|https://cwiki.apache.org/confluence/display/Hive/HCatalog+StorageFormats]
*** already linked to Hive [SerDe|https://cwiki.apache.org/confluence/display/Hive/SerDe]
*** needs a link to Hive Language Manual's [ORC Files|https://cwiki.apache.org/confluence/display/Hive/LanguageManual+ORC]
*** if we ever get docs for other file formats, add links to them 
** Hive docs
*** link DDL's [Row Format, Storage Format, and SerDe|https://cwiki.apache.org/confluence/display/Hive/LanguageManual+DDL#LanguageManualDDL-RowFormat%2CStorageFormat%2CandSerDe]
to HCatalog doc, and vice versa
*** [SerDe|https://cwiki.apache.org/confluence/display/Hive/SerDe] needs links from other
Hive docs 
*** Getting Started and Tutorial could have links to DDL doc's "Row Format, Storage Format,
and SerDe"
*** design doc [Hive Storage Handlers|https://cwiki.apache.org/confluence/display/Hive/StorageHandlers]
should be included somehow in the Language Manual's "File Formats" section, or linked from
there

*Background:*  In a hive-dev discussion last May, [~cwsteinbach] said he preferred integrating
the HCatalog & WebHCat docs with the Hive docs, rather than keeping them in separate lumps.
 I found that approach intractable, so these links are an attempt to integrate all the docs
with cross-references.  See "Re: Moving HCatalog docs to wiki" here: 

* Carl's preference:  [16 May 22:16 GMT|http://mail-archives.apache.org/mod_mbox/hive-dev/201305.mbox/%3cCACf6RrwjsoWyQZPRZJWB_+NSDfwSvxxfG+nduXyWb6E+1m0ggQ@mail.gmail.com%3e]

* earlier messages:  [16 May 04:09 GMT|http://mail-archives.apache.org/mod_mbox/hive-dev/201305.mbox/%3cCAATF2qgzikuS=j_hVHAyFWNvX77P0AcWhs49=zWSc0AvmLojNQ@mail.gmail.com%3e]
-- note unfinished tasks:  move the old HCat wiki into Hive (where?), remove HCat tabs, update
Hive description to include HCat -- oh, you just did that, thanks Thejas.

But it's easy to move things around now that all the docs are in wiki format.  The HCatalog
& WebHCat overview pages could point to docs in other locations.  Navigation links at
the bottom of each wikidoc would keep the original order available for anyone who wants to
access the docs that way.  So I welcome alternative organization ideas.


> Add WebHCat (Templeton) documentation to Hive wiki
> --------------------------------------------------
>
>                 Key: HIVE-4994
>                 URL: https://issues.apache.org/jira/browse/HIVE-4994
>             Project: Hive
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 0.11.0
>            Reporter: Lefty Leverenz
>            Assignee: Lefty Leverenz
>
> WebHCat (Templeton) documentation in the Apache incubator had xml source files which
generated html & pdf output files.  Now that HCatalog and WebHCat are part of the Hive
project, all the WebHCat documents need to be added to the Hive wiki.



--
This message was sent by Atlassian JIRA
(v6.1#6144)

Mime
View raw message