adoptium / adoptium.net

Adoptium Website

Adoptium Site

This repository contains the source code for https://adoptium.net.

The main branch contains the source code necessary for development. The production site is hosted on Netlify which also supports pull request staging.

Tech Stack

This is is a Node.js / npm driven stack with AsciiDoc used for static content and Gatsby as the rendering engine etc.

How to develop locally

This assumes you already have Node.js and npm installed. Node.js version 18 or above is required. We recommend using nvm to manage your versions.

1. Install your dependencies

   npm install

2. Start the site up. Gatsby will build all of the various parts of the site (Asciidoc etc). Note that this command takes some time to execute.

   npm start

3. If you need more memory (FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory)

   export NODE_OPTIONS=--max-old-space-size=4096

4. Open the source code and start editing!

   Your site is now running at http://localhost:8000!

   Note: You'll also see a second link:http://localhost:8000/___graphql. This is a tool you can use to experiment with querying your data. Learn more about using this tool in the Gatsby tutorial.

   Open the directory in your code editor of choice and edit relevant files under the src/ directory. Save your changes and the browser will update in real time!

Configuring the build

gatsby-config.ts is effectively your build script and gatsby-node.ts is where the Asciidoc rendering takes place.

How to contribute

See CONTRIBUTING.md

adoptium.net's Issues

Investigate creation of a news feed

Similar to something like

https://ecdtools.eclipse.org/resources/news/

What would it entail to create a feed for Adoptium news feed.

Automatically mark external asciidoc links as external

We should add target=_blank to all external links in asciidoc documents

Navbar on mobile doesn't render correctly

Currently the navbar is transparent which means that it's not visible over white backgrounds

Investigate localisation working

We need to work out how to implement this

Add TCK Affidavit Page

For use in the Marketplace

Homepage design mock-ups

The Adoptium Marketing Committee had asked the EF design team to make some recommendations for the homepage design, based on the current staging site: https://eclipsefdn-adoptium-v2.netlify.app/

@meKokabi has come up with a couple of ideas: https://xd.adobe.com/view/d1d4e477-9322-4d7a-93ac-1e2de26a910b-8487/

We are looking for community input on the design, so please provide your feedback.

Add OS/ARCH/Package Type filters to Latest Temurin page

blocked by adoptium/api.adoptium.net#305

Add infrastructure sponsors to sponsors page

Add a banner to the website

adoptium.net has often used a pink banner at the top of the page to share release updates and other relevant information. We should provide a similar banner for this website.

Example of the current banner:

Add global attributes to asciidoc

We should use global attributes to set variables that are used on multiple pages (e.g latest Temurin 8 version) this will also make it easier to update the variables when we do releases

Embed the Donate button into the post-download thank you page

After discussion in the Steering committee call, we would like to add embedding the new "Donate to the Adoptium Working Group" button into the post-download thank you page.

see: https://www.eclipse.org/donate/adoptium/

Latest release page does not have clickable github release links

Originally discussed in AdoptOpenJDK/openjdk-website#753

Blocked by: adoptium/api.adoptium.net#316

Marketplace vendor selector should randomise order

The current vendor selector (which would more rightly be called "publisher selector") displays the options in a fixed order. It should present in a random order to ensure users have an unbiased choice.

/temurin/releases/ no longer has a source tarball

Since the move to the new website there are no more links to the source tarball archives available. I believe this is still available via the API:

curl -v https://api.adoptium.net/v3/binary/latest/17/ga/linux/x64/sources/hotspot/normal/eclipse
*   Trying 20.62.244.126:443...
* Connected to api.adoptium.net (20.62.244.126) port 443 (#0)
* ALPN, offering h2
* ALPN, offering http/1.1
* successfully set certificate verify locations:
*  CAfile: /etc/pki/tls/certs/ca-bundle.crt
*  CApath: none
* TLSv1.3 (OUT), TLS handshake, Client hello (1):
* TLSv1.3 (IN), TLS handshake, Server hello (2):
* TLSv1.2 (IN), TLS handshake, Certificate (11):
* TLSv1.2 (IN), TLS handshake, Server key exchange (12):
* TLSv1.2 (IN), TLS handshake, Server finished (14):
* TLSv1.2 (OUT), TLS handshake, Client key exchange (16):
* TLSv1.2 (OUT), TLS change cipher, Change cipher spec (1):
* TLSv1.2 (OUT), TLS handshake, Finished (20):
* TLSv1.2 (IN), TLS handshake, Finished (20):
* SSL connection using TLSv1.2 / ECDHE-RSA-AES256-GCM-SHA384
* ALPN, server accepted to use http/1.1
* Server certificate:
*  subject: CN=api.adoptium.net
*  start date: Mar 12 10:32:55 2022 GMT
*  expire date: Jun 10 10:32:54 2022 GMT
*  subjectAltName: host "api.adoptium.net" matched cert's "api.adoptium.net"
*  issuer: C=US; O=Let's Encrypt; CN=R3
*  SSL certificate verify ok.
> GET /v3/binary/latest/17/ga/linux/x64/sources/hotspot/normal/eclipse HTTP/1.1
> Host: api.adoptium.net
> User-Agent: curl/7.79.1
> Accept: */*
> 
* Mark bundle as not supporting multiuse
< HTTP/1.1 307 Temporary Redirect
< Date: Thu, 21 Apr 2022 16:54:49 GMT
< Content-Type: application/octet-stream
< Content-Length: 0
< Connection: keep-alive
< Location: https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.2%2B8/OpenJDK17U-sources_17.0.2_8.tar.gz
< 
* Connection #0 to host api.adoptium.net left intact

Add Nightly Page

Nightly needs adding

Add Legends where visual language is used

The Supported Platforms pages use icons without defining the semantics. I am currently not aware of additional locations.

Adding small legends everywhere where icons are increases the accessibility of Adoptium's documentation/website.

Provide a download button for the Adoptium Temurin JDK/JRE builds for promotional purposes

This is a request for the marketing department probably.

Oracle allows users to promote Oracle JDK builds with an official download button logo. See also
https://www.oracle.com/java/java-affinity/download-buttons.html

I think it would be great if Adoptium could provide something similar for their builds. I would love to promote https://adoptium.net/ if I could use an official download button. However, I have not found an official download button on the adoptium.net website that I could use for this purpose.

Adoptium download page should include release date and EOL date.

Summary
Adoptium download page should include release date and EOL date. When I am deciding which download to choose, it would be useful to know how fresh it is and how long it will be supported.

Steps to reproduce
Visit the download page and note there is no information about dates of kind.

What is the current bug behavior?
You can't tell, when choosing your download, what the support time frame (LTS) is.

What is the expected correct behavior?
It would be nice to have this information readily available. If not on the page directly, then at least provide a link to a summary of this information.

Relevant logs and/or screenshots
https://adoptium.net/temurin/releases
Originally [incorrectly] posted at https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/issues/1168

Download page should be robust to misuse

The download page expects a parameter to ensure the correct download is initiated. When that parameter is not available, likely by the user directly accessing the page, it currently prints out an "oops" message, but it would be more helpful where there is no location provided to redirect the user to the latest releases page (likely using navigate and replace history).

The "oops" error can be retained for internal problems resolving the location link.

Bookmark Support

Have all the builds on display by a bookmark-able link.

e.g. https://adoptium.net/temurin/releases/?os=win&arch=x64&package=jdk
Should show all the builds available for download, matching the signature (Windows + x64 + JDK), ordered from newest to oldest.

Without such support, having to re-select OS, architecture and package type over and over again becomes tedious and a time-waster.

Enable github super lint action

We need to lint this website before things get out of control!

Investigate solutions to keep i18n docs up to date with english ones

Snapshot from a conversation with @tellison discussing ideas:

Each doc has a version e.g 1.0.0

We bump the English one to 1.0.1 but the German one is still at 1.0.0 so we add a banner to the top of the page saying something like:

“This documentation may be out of date please help us bring it up to date by contributing to the project”

We could go one step further and instead of having versions have a based-on value in the translated page which contains the git sha of the English version

We can then programmatically produce a diff which we can show prospective translators to help them understand which bits need changing

Update marketplace page to use Adoptium API

Currently marketplace page is still using Disco API. Creating this issue to capture the wish to switch over to use the in-house Adoptium API (which is currently being augmented to support marketplace requirements).

Add logo usage guidelines page

@hendrikebbers starting working on this in the documentation repo but this can likely be completed in this project now

404 for link to Eclipse Foundation Quality Verification Suite License

On:
https://eclipsefdn-adoptium-v2.netlify.app/docs/marketplace-policy/

There is text:
Eclipse Foundation Quality Verification Suite License

Linking to:
https://www.eclipse.org/legal/documents/eclipse-foundation-quality-verification-suite-license.php

Which shows 404 not found.

Mark Temurin builds as AQAvit verified

We should add a note (similar to the TCK mark) for the binaries

Show ARM build for Macs

• Browser:

Safari Version 15.1 (17612.2.9.1.20)

I'm on an Apple Silicon Mac but the Adoptium webpage wants to give me the x64 version.

It would be great if I was given the choice of which version to download from the homepage, many people may not realise that there is an ARM build of the JDK, or that the one they are downloading is Intel.

I realise I can pick the other packages below but it's not obvious to a user that this might be something they'd want to do when they're presented with a good looking option.

There doesn't seem to be any particularly good ways of detecting if a Mac is Intel or ARM so just showing both seems like a decent option.

Deep link syntax to preselect JDK version

Dear adoptium team,

Marc here from javaalmanac.io. I noticed that my deep links to adoptium.net stopped working. So what I basically do is to offer users direct links to different distrubutions, for example:

https://javaalmanac.io/jdk/11/

Is the a possibility to pre-select for example Version 11 on your download page? For example something like

https://adoptium.net/temurin/releases?version=11

Thanks for your great work,
-marc

Complete Linux installer instructions in terminal component

We need to add the RPM/DEB instructions to the terminal in https://eclipsefdn-adoptium-v2.netlify.app/installation (at the top)

Currently they point at NVM (as they were copied from the Node.js) component and need updating

Investigate whether docs resources can be stored in relative directory rather than static

Exclude dependabot from committer highlight section

When seeing the preview on https://eclipsefdn-adoptium-v2.netlify.app/ the committer highlight section on the front page can show dependabot. I think it would be fine to exclude dependabot from the eligible candidates.

Add Eclipse Cookies policy to page

ping @chrisguindon for guidance here, can you remind me of the instructions?

Download Vendor logos rather than serving them from remote URLs

Create cherished URLs for external documentation

In order to have reliable URLs published in external Eclipse Foundation documentation, the following links should be maintained by the website code.

• https://www.adoptium.net/marketplace
  Always points to the website's marketplace UI for end users.

• https://www.adoptium.net/marketplace-policy
  Always points to the marketplace policy documentation, primarily used for describing the producer and product inclusion criteria.

• https://www.adoptium.net/qvs-policy
  Always points to the AQAvit name usage policy documentation and license information. May link to, but not designed to include, the technical information about running AQAvit verification.

Add QVSL information

we need to host the guidelines in asciidoc for how to sign the QVSL agreement

Missing link to https://status.adoptium.net/ in nav bar

We need to add a link to the Adoptium status site in the navigation bar.

Steps to implement:

1. Add a new line to https://github.com/adoptium/website-v2/blob/main/src/components/Navbar.tsx#L78 (same format as the blog and API links)

See https://github.com/adoptium/website-v2#how-to-develop-locally for more information on contributing to this website

Add installation instructions for MacPorts

I am the maintainer of the openjdk*-temurin ports in MacPorts. I recently contributed installation instructions, but I see the website has been replaced with a new version. The instructions can still be found on the old site here: https://old.adoptium.net/installation.html#macports

I looked at the code for the new site, but it seems there is currently a one-to-one mapping from operating system to package manager, which doesn't allow for easily adding a second package manager for an operating system. I'm afraid I don't understand React well enough to refactor the code to allow for instructions for two package managers for a single operating system, but it would be nice if the MacPorts instructions could be restored on the new website.

How to integrate the donate page

https://www.eclipse.org/donate/adoptium/

maybe use the GitHub funding.yml file too?

Add Google gtag plugin

Start to collect website analytics using the gatsby-plugin-google-gtag plugin with measurement ID G-9HHPS5RX9D.

Add section for SDKMAN on installation page

Hi all,

First off, thanks for your tremendous effort so far. We all appreciate the hard work you are putting in.

I noticed that your installation page makes no mention of SDKMAN right now, and was wondering if I could raise a PR to add it, as well as get some guidance around what could be added to that page.

You might already know that Temurin 17 is the new default JDK installation on SDKMAN, so installing is a doddle 😄

Thanks and keep up the great work!

Show supported platforms on Docker using fontaweome icon

It would be good to add the supported platforms for docker here

Add source code download to temurin release pages

Bookmark Support

Have all the builds on display by a bookmark-able link.

e.g. https://adoptium.net/temurin/releases/?os=win&arch=x64&package=jdk
Should show all the builds available for download, matching the signature (Windows + x64 + JDK), ordered from newest to oldest.

Without such support, having to re-select OS, architecture and package type over and over again becomes tedious and a time-waster.

Create a docs homepage

We need to create a homepage for the docs that allows us to search etc.

Looking at something like https://docs.microsoft.com/java/ for inspiration

Add a checksum rendering popup

Currently, the checksum links just point to google.com. This needs implementing

Thank you box should not include bots

The Adoptium website thanks contributors by showing a box at the bottom of each page.

This thank you randomly selects a contributor from various project repositories, however, it currently includes automated bot "contributions".

The code should be updated to ignore known bots from the thank-you (by selecting a new contributor who is not in a list of known bots).

MacOS JDK8 tar.gz checksum not identical

The Checksum for the MacOS JDK8 (jdk8u322-b06) tar.gz - File is not identical.

Filename: OpenJDK8U-jdk_x64_mac_hotspot_8u322b06.tar

SHA265 Checksum on adoptium: 96a3124bf0f5ca777954239893cc89ea34c4bc9a9b7c1559aa2c69baa0ee84e3
SHA265 Checksum from downloaded file: bd8883b6b90e01b05c58b5eb263b0566a6c2f652ae444e4fcb496937218a1281

My apologies if this is not the correct place to post - I'm new.

Homepage download button does not work for non en locales

The home page download latest LTS release does not work in locales other than en.

To recreate, load the home page in de locate, https://adoptium.net/de/ and click on the download button. Notice that the page reports "Ooops - something doesn't seem quite right here. Please try again.".

Expected behavior is to start the download.

Add Release Notes page

Currently Adoptium uses the following page: https://adoptium.net/release_notes.html

Temurin download site results in "flip-flopping" of the follow on page

Reproduced in Firefox 98.0.2 on both Linux/x64 and Windows/aarch64. The download page constantly toggles between these two pages and does not initiate a download when you click the download links on https://adoptium.net/temurin/releases/

Here are the two pages it toggles between - the second indicates an error condition: