<div dir="auto"><div><div class="gmail_quote gmail_quote_container"><div dir="ltr" class="gmail_attr">Magnus Ihse Bursie <<a href="mailto:magnus.ihse.bursie@oracle.com">magnus.ihse.bursie@oracle.com</a>> schrieb am Do., 19. Juni 2025, 15:22:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On 2025-06-18 15:51, Volker Simonis wrote:<br>
<br>
> On Tue, Jun 17, 2025 at 4:21 PM Magnus Ihse Bursie<br>
> <<a href="mailto:magnus.ihse.bursie@oracle.com" target="_blank" rel="noreferrer">magnus.ihse.bursie@oracle.com</a>> wrote:<br>
>><br>
>> On 2025-06-16 18:35, Volker Simonis wrote:<br>
>>> On Mon, Jun 16, 2025 at 12:07 PM Magnus Ihse Bursie<br>
>>> <<a href="mailto:magnus.ihse.bursie@oracle.com" target="_blank" rel="noreferrer">magnus.ihse.bursie@oracle.com</a>> wrote:<br>
>>>> What links are you referring to?<br>
>>> Sorry for the confusion. I just realized that the links to<br>
>>> `doc/building.{md,html}` are relative links and  therefor already<br>
>>> pointing to the correct files.<br>
>>><br>
>>> However, the link to the `online documentation` is pointing to<br>
>>> `<a href="https://openjdk.org/groups/build/doc/building.html" rel="noreferrer noreferrer" target="_blank">https://openjdk.org/groups/build/doc/building.html`</a> which isn't even<br>
>>> at GitHub but on <a href="http://openjkd.org" rel="noreferrer noreferrer" target="_blank">openjkd.org</a> and I don't know when and how that is<br>
>>> updated (in any case, it's currently just a single, static file for<br>
>>> all JDK versions). Instead, I propose to replace the link by something<br>
>>> like <a href="https://htmlpreview.github.io/?https://github.com/openjdk/jdk/blob/jdk25/doc/building.html" rel="noreferrer noreferrer" target="_blank">https://htmlpreview.github.io/?https://github.com/openjdk/jdk/blob/jdk25/doc/building.html</a><br>
>>> which will serve the current file as HTML and make it always<br>
>>> up-to-date. Actually, once we have that, we could even remove the link<br>
>>> to `<a href="https://github.com/openjdk/jdk/blob/jdk25/doc/building.html" rel="noreferrer noreferrer" target="_blank">https://github.com/openjdk/jdk/blob/jdk25/doc/building.html`</a><br>
>>> because looking at a raw HTML file is pretty inconvenient if you're<br>
>>> searching for build information.<br>
>> Well, that is just what<br>
>> <a href="https://openjdk.org/groups/build/doc/building.html" rel="noreferrer noreferrer" target="_blank">https://openjdk.org/groups/build/doc/building.html</a> is. It is not a<br>
>> static page, it is a stable and comprehensible URL that gets the build<br>
>> README directly from Github (but presented as text/html from the server,<br>
>> which is something Github does not do).<br>
> OK, I see now, <a href="https://openjdk.org/groups/build/doc/building.html" rel="noreferrer noreferrer" target="_blank">https://openjdk.org/groups/build/doc/building.html</a> uses<br>
> iframe magic and <a href="https://htmlpreview.github.io" rel="noreferrer noreferrer" target="_blank">https://htmlpreview.github.io</a> under the hood to serve<br>
> the actual file as HTML. But this only the correct build.html file for<br>
> the master branch and not for the older release branches.So why do we<br>
> need this indirection through<br>
> <a href="https://openjdk.org/groups/build/doc/building.html" rel="noreferrer noreferrer" target="_blank">https://openjdk.org/groups/build/doc/building.html</a> and can not place<br>
> the link to <a href="https://htmlpreview.github.io/?https://raw.githubusercontent.com/openjdk/jdk/master/doc/building.html" rel="noreferrer noreferrer" target="_blank">https://htmlpreview.github.io/?https://raw.githubusercontent.com/openjdk/jdk/master/doc/building.html</a><br>
> right into the README.md file as I proposed? This would allow us to<br>
> point to the correct build.html in a branch while currently e.g. the<br>
> link in <a href="https://github.com/openjdk/jdk/blob/jdk23/README.md" rel="noreferrer noreferrer" target="_blank">https://github.com/openjdk/jdk/blob/jdk23/README.md</a> will show<br>
> us <a href="https://raw.githubusercontent.com/openjdk/jdk/master/doc/building.html" rel="noreferrer noreferrer" target="_blank">https://raw.githubusercontent.com/openjdk/jdk/master/doc/building.html</a><br>
> instead of the correct (and different)<br>
> <a href="https://raw.githubusercontent.com/openjdk/jdk/jdk23/doc/building.html" rel="noreferrer noreferrer" target="_blank">https://raw.githubusercontent.com/openjdk/jdk/jdk23/doc/building.html</a>.<br>
<br>
I don't think it is proper to point official URLs to <a href="http://non-openjdk.org" rel="noreferrer noreferrer" target="_blank">non-openjdk.org</a> <br>
resources.</blockquote></div></div><div dir="auto"><br></div><div dir="auto">Saying that pointing to non <a href="http://openjdk.org">openjdk.org</a> resources is "not proper" and instead pointing to another <a href="http://openjdk.org">openjdk.org</a> resource which injects the non <a href="http://openjdk.org">openjdk.org</a> content in an iframe is obviously lying to oneself.</div><div dir="auto"></div><div dir="auto"><br></div><div dir="auto"><div class="gmail_quote gmail_quote_container"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">As I said, I think it would be enough to point to just the <br>
markdown file, and it resides in the current repo and thus needs just a <br>
local link.<br></blockquote></div></div><div dir="auto"><br></div><div dir="auto">That's fine for me.</div><div dir="auto"><br></div><div dir="auto"><div class="gmail_quote gmail_quote_container"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
The point is that people are not really supposed to build the frozen GA <br>
versions, so we should not really go overboard with linking to a build <br>
README...<br>
<br>
As for the update releases, that is a question for the JDK Updates project.<br>
<br>
/Magnus<br>
<br>
</blockquote></div></div></div>