I haven't found any simple way how we could add canonical links to javadoc. It is difficult to achieve because the content needs to be compared between versions and canonical link is only applicable when the these are identical. Moving classes to different packages from version A to B introduces additional complexity. I created HBASE-21869 to track this work.
Regarding the 0.94 removal I created a PR to hbase-site repository with new .htaccess rules. See: https://github.com/apache/hbase-site/pull/1 On Tue, Feb 5, 2019 at 3:40 PM Misty Linville <[email protected]> wrote: > For 0.94 files we should add a permanent redirect to htaccess manually. For > the rest we should modify the javadoc template to add the correct metadata > for older branches. There is probably a way to pass arguments to the > javadoc command and maybe that could be toggled on or off depending on > whether we were building the latest or not. You’ll need to look up the > actual syntax you need and how to achieve it in the template. We should > avoid modifying generated content manually so we don’t blow our hashes in > released bundles. > > Before you do any of this, please outline at least a rough plan so we can > help spot problems. :) > > Misty > > On Tue, Feb 5, 2019 at 4:44 AM Peter Somogyi <[email protected]> wrote: > > > That's a very good point Nick! > > > > I'd know how we could add rel=canonical tag to 0.94 pages if we remove > > those. Also, how could we add this tag to generated javadoc files (e.g. > > canonical link between 1.4 and 3.0 javadoc)? I did not find any solutions > > online to automate this process. > > What we can do is to add a redirect rule to .htaccess with something like > > this: > > > > RedirectMatch permanent ^/0.94/(.*)$ /$1 > > > > I think it could work for most of the links. An example: > > > > > https://hbase.apache.org/devapidocs/org/apache/hadoop/hbase/client/HTable.html > > > > > https://hbase.apache.org/0.94/devapidocs/org/apache/hadoop/hbase/client/HTable.html > > > > On Tue, Feb 5, 2019 at 3:58 AM Misty Linville <[email protected]> wrote: > > > > > We should add rel=canonical info to all the headers and always point to > > the > > > latest as canonical. > > > > > > On Mon, Feb 4, 2019 at 2:56 PM William Shen < > [email protected]> > > > wrote: > > > > > > > If we are concerned about SEO, we should try to set up 301 Redirect > to > > > the > > > > latest doc when we remove 0.94. That should alleviate some of the > > > problems > > > > with users landing on dead links. Over time the result should adjust, > > or > > > we > > > > could set up Google Search Console for HBase site, and trigger a > > reindex. > > > > Not sure if we have someone already owning the SEO aspect of the > site. > > > > > > > > On Mon, Feb 4, 2019 at 2:52 PM Nick Dimiduk <[email protected]> > > wrote: > > > > > > > > > My only concern is that all my searches targeting our user guide > land > > > in > > > > > 0.94 docs. I don't know why the SEO lands us thusly, but I fear > that > > > > > suddenly it'll look to user searches like the project is dead. > > > > > > > > > > On Mon, Feb 4, 2019 at 11:46 AM Misty Linville <[email protected]> > > > wrote: > > > > > > > > > > > +1 > > > > > > > > > > > > On Mon, Feb 4, 2019 at 10:04 AM Stack <[email protected]> wrote: > > > > > > > > > > > > > Sounds good by me. > > > > > > > S > > > > > > > > > > > > > > On Mon, Feb 4, 2019 at 7:40 AM Peter Somogyi < > > [email protected]> > > > > > > wrote: > > > > > > > > > > > > > > > Does anyone have any concern with removing 0.94 documentation > > > > > > completely > > > > > > > > from hbase.apache.org? Currently it is hosted at > > > > > > > > https://hbase.apache.org/0.94/ to which we don't have any > > direct > > > > > link > > > > > > > but > > > > > > > > with a few hops a user can reach this area. This release is > > > almost > > > > 4 > > > > > > > years > > > > > > > > old! > > > > > > > > > > > > > > > > I had a chat with Sean Busbey and he mentioned 0.94 could be > > > > removed > > > > > > from > > > > > > > > the site and we could send a NOTICE to user@ that the > > > > documentation > > > > > > can > > > > > > > be > > > > > > > > found in the final 0.94 tarball in case anyone still need it. > > The > > > > > > > > tarball[1] has the same content in docs directory. > > > > > > > > > > > > > > > > What do you think? > > > > > > > > > > > > > > > > Peter > > > > > > > > > > > > > > > > [1] http://archive.apache.org/dist/hbase/hbase-0.94.27/ > > > > > > > > > > > > > > > > On Tue, Jan 29, 2019 at 10:18 PM Sakthi < > > > > [email protected]> > > > > > > > > wrote: > > > > > > > > > > > > > > > > > FYI: This is the job I'm talking about: > > > > > > > > > > > > https://builds.apache.org/job/HBase%20Website%20Link%20Checker/ > > > > > > > > > > > > > > > > > > Regards, > > > > > > > > > Sakthi > > > > > > > > > > > > > > > > > > On Tue, Jan 29, 2019 at 11:17 AM Sakthi < > > > > > [email protected]> > > > > > > > > > wrote: > > > > > > > > > > > > > > > > > > > Hello all, > > > > > > > > > > > > > > > > > > > > The most recent (and many of the previous) "*HBase > Website > > > Link > > > > > > > > Checker*" > > > > > > > > > > job of ours has reported several issues with the website. > > The > > > > job > > > > > > > takes > > > > > > > > > > roughly 20+ hours to finish and has reported "*1458 > missing > > > > > files*" > > > > > > > and > > > > > > > > > "*7143 > > > > > > > > > > missing named anchors*". > > > > > > > > > > > > > > > > > > > > *Quick facts:* Of the 1400+ missing files issues, around > > 1200 > > > > are > > > > > > > from > > > > > > > > > > 1.2, 90 from 0.94, 40 from 2.0, 30 from 2.1 and rest from > > the > > > > > > master. > > > > > > > > > > > > > > > > > > > > I have filed an *Umbrella JIRA:* HBASE-21803 > > > > > > > > > > <https://issues.apache.org/jira/browse/HBASE-21803> > > ("HBase > > > > > > Website > > > > > > > > > > Cleanup"). If folks find any other website related issues > > > that > > > > we > > > > > > > would > > > > > > > > > > like to address, we can use this umbrella to track it. > > > > > > > > > > > > > > > > > > > > Any suggestions are welcome! > > > > > > > > > > > > > > > > > > > > Regards, > > > > > > > > > > Sakthi > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > >
