Re: Change in generated files for SE API docs, caused by change to not generate frames

2018-06-04 Thread mark . reinhold
2018/6/4 15:54:34 -0700, marti...@google.com: > TIL about Canonical link element and 301 redirects. You get to decide > whether to follow the joint advice of Google and Microsoft > https://en.wikipedia.org/wiki/HTTP_301#Search_engines Sure, a 301 would be preferable, but it’s not always easy to a

Re: Change in generated files for SE API docs, caused by change to not generate frames

2018-06-04 Thread Jonathan Gibbons
The doclet already has code to generate redirect pages;  given the short time available for 11, I would prefer to go with what we have. Also, I'm not sure that we can generate a 301 redirect from within a static web page. -- Jon On 6/4/18 3:54 PM, Martin Buchholz wrote: TIL about Canonical

Re: Change in generated files for SE API docs, caused by change to not generate frames

2018-06-04 Thread Martin Buchholz
TIL about Canonical link element and 301 redirects. You get to decide whether to follow the joint advice of Google and Microsoft https://en.wikipedia.org/wiki/HTTP_301#Search_engines On Mon, Jun 4, 2018 at 3:45 PM, Jonathan Gibbons < jonathan.gibb...@oracle.com> wrote: > > > On 06/04/2018 03:39

Re: Change in generated files for SE API docs, caused by change to not generate frames

2018-06-04 Thread Jonathan Gibbons
On 06/04/2018 03:39 PM, mark.reinh...@oracle.com wrote: I don't know much about >search engines (!) but maybe there's metadata to tell search engines what >the canonical URL is (or maybe simply redirects are interpreted that way). Indeed, there is:https://en.wikipedia.org/wiki/Canonical_lin

Re: Change in generated files for SE API docs, caused by change to not generate frames

2018-06-04 Thread mark . reinhold
2018/6/4 14:17:47 -0700, Martin Buchholz : > On Mon, Jun 4, 2018 at 2:11 PM, jonathan.gibb...@oracle.com wrote: >> ... >> >> So, what are our options. >> >> 0. Do nothing. People, and search engines, will learn to use a URL >> ending in "api/" or "api/index.html" >> >> 1. Back out the change.

Re: Change in generated files for SE API docs, caused by change to not generate frames

2018-06-04 Thread Martin Buchholz
On Mon, Jun 4, 2018 at 2:11 PM, Jonathan Gibbons < jonathan.gibb...@oracle.com> wrote: > JDK-8196202 [1] introduced a change to the javadoc tool (and because of > that, to the Java SE API documentation) such that frames are not generated > by default. > > This has had a deliberate but somewhat une

Change in generated files for SE API docs, caused by change to not generate frames

2018-06-04 Thread Jonathan Gibbons
JDK-8196202 [1] introduced a change to the javadoc tool (and because of that, to the Java SE API documentation) such that frames are not generated by default. This has had a deliberate but somewhat unexpected consequence on the Java SE API docs, of getting "404: Not found" on URLs that explici