Home | About | Sematext search-lucene.com search-hadoop.com
 Search Hadoop and all its subprojects:

Switch to Plain View
Hive >> mail # user >> Broken Hive docs -- links not working


+
Lefty Leverenz 2013-09-02, 22:37
Copy link to this message
-
Re: Broken Hive docs -- links not working
The best way to get this resolved is to file an ASFINFRA JIRA ticket. It
doesn't look like any of us have the privileges necessary to stop the
autoexport job, so the ball is clearly in INFRA's court.

Thanks.

Carl
On Mon, Sep 2, 2013 at 3:37 PM, Lefty Leverenz <[EMAIL PROTECTED]>wrote:

> Edward Capriolo talked about broken links in the Hive wiki in another
> thread on the users list ("What is this windowing query supposed to do?")
> so I'm moving the discussion here.
>
> Recap:
>
> Edward:
>
> > Most of the links here:
> > https://cwiki.apache.org/Hive/languagemanual.html
> >
> > are broken...
> > What gives?
> > The language manual used to be fairly useful, now it is in major
> dis-array.
> >
>
> Lefty:
>
> > Once again the /confluence/display version of the wiki is fine while the
> > non-display version is glitchy.  First the {code} tags gave invisible
> > sample code, and now some of the doc links don't work -- but they're fine
> > here:  https://cwiki.apache.org/confluence/display/Hive/LanguageManual.
> >
> > Can anyone explain this, or better yet solve it?  Until it's solved,
> > should we include a link to the display version at the top of each
> wikidoc?
> >
>
> Edward:
>
> > The problem is if you follow our site from the main page you find the
> > broken docs, not the confluence ones.
> >
>
> New reply from Lefty:  Do you mean the Wiki tab?  When I follow it, I go to
> the "display" version at
> https://cwiki.apache.org/confluence/display/Hive/Home, not the broken
> version at https://cwiki.apache.org/Hive/home.html.
>
> Another problem is that there's no link to the wiki in the menu under
> Documentation.  That can be fixed fairly easily, so I'll open a JIRA.
>
> Spot check for broken links in the non-display
> version<https://cwiki.apache.org/Hive/home.html>
> :
>
>    - Getting Started:  404 Not Found
>    (https://cwiki.apache.org/Hive/gettingstarted.html)
>    - Tutorial:  404 Not Found
>    (https://cwiki.apache.org/Hive/tutorial.html)
>    - Language Manual:  okay
>    (https://cwiki.apache.org/Hive/languagemanual.html)
>    - Operators and Functions: 404 Not Found
>    (https://cwiki.apache.org/Hive/operatorsandfunctions.html)
>    - Web Interface:  404 Not Found
>    (https://cwiki.apache.org/Hive/hivewebinterface.html)
>    - Hive Client: okay
>    (https://cwiki.apache.org/Hive/hiveclient.html)
>    - HiveServer2 Clients:  okay
>    (https://cwiki.apache.org/Hive/hiveserver2-clients.html)
>    - Change Log:  404 Not Found
>    (https://cwiki.apache.org/Hive/hivechangelog.html)
>    - Avro SerDe:  okay
>    (https://cwiki.apache.org/Hive/avroserde.html)
>
> So much for my hope of finding a pattern.  Now to check how the links are
> marked up:
>
> h1. General Information about Hive
>
> * [Getting Started|GettingStarted]
> [...]
>
> h1. User Documentation
>
> * [Hive Tutorial|Tutorial]
> * [HiveQL Language Manual (Queries, DML, DDL, and CLI)|LanguageManual]
> * [Hive Operators and Functions|OperatorsAndFunctions]
> * [Hive Web Interface|HiveWebInterface]
> * [Hive Client (JDBC, ODBC, Thrift, etc)|HiveClient]
> * [HiveServer2 Client|
> https://cwiki.apache.org/confluence/display/Hive/HiveServer2+Clients]
> * [Hive Change Log|HiveChangeLog]
> * [Avro SerDe|AvroSerDe]
>
>
> Again, nothing obvious.  I think the use of a URL for HS2 Clients was just
> to get around the space in the title, but there's probably another way to
> do it -- I'll check my notes and fix it if I can.
>
> I'll check a few more later, but this doesn't seem to be fruitful
> debugging.  It isn't a matter of new vs. old docs (both Hive Client and HS2
> Clients are okay).  All of these links work fine in the
> "display<https://cwiki.apache.org/confluence/display/Hive/Home>"
> version of the wiki.  Most of them are top-level files in the
> hierarchy<
> https://cwiki.apache.org/confluence/pages/listpages-dirview.action?key=Hive&openId=27362069#selectedPageInHierarchy
> >,
> except for Operators and Functions (a broken link), HiveServer2 Clients (a