You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@hive.apache.org by Lefty Leverenz <le...@gmail.com> on 2013/09/03 00:37:18 UTC
Broken Hive docs -- links not working
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
Re: Broken Hive docs -- links not working
Posted by Carl Steinbach <cw...@gmail.com>.
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 <le...@gmail.com>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
> link that works), and Hive Change Log (broken) and those are all children
> of the Home page.
>
> It's a mystery.
>
> -- Lefty
>
Re: Broken Hive docs -- links not working
Posted by Carl Steinbach <cw...@gmail.com>.
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 <le...@gmail.com>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
> link that works), and Hive Change Log (broken) and those are all children
> of the Home page.
>
> It's a mystery.
>
> -- Lefty
>