[ 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+1m0...@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=zwsc0avmlo...@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)