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

Switch to Threaded View
Hive, mail # user - Broken Hive docs -- links not working


Copy link to this message
-
Broken Hive docs -- links not working
Lefty Leverenz 2013-09-02, 22:37
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
link that works), and Hive Change Log (broken) and those are all children
of the Home page.

It's a mystery.

-- Lefty