Bump project version to 5.10.0 and update docs

Author: lesserwhirls

docs/src/site/_config.yml

@@ -2,7 +2,7 @@
 theme: unidata-jekyll-theme
 
 # this will appear in an HTML meta tag, sidebar, and perhaps elsewhere
-docset_version: 5.9
+docset_version: 5.10
 
 # this appears on the top navigation bar next to the home button
 topnav_title: netCDF-Java

docs/src/site/pages/netcdfJava/Upgrade.md

@@ -1,26 +1,18 @@
 ---
 title: Upgrading to netCDF-Java version 5.x
-last_updated: 2025-08-08
+last_updated: 2025-10-30
 sidebar: netcdfJavaTutorial_sidebar
 toc: false
 permalink: upgrade.html
 ---
 
 ## Requirements
 
-* Java 8 or later is required
-
-## Overview
-
-A number of API enhancements have been made to take advantage of evolution in the Java language, for example _try-with-resource_ and _foreach_ constructs.
-The use of these make code simpler and more reliable.
-
-Deprecated classes and methods have been removed, and the module structure and third-party jar use has been improved.
-
-Java WebStart has been deprecated as of [Java 9](https://www.oracle.com/technetwork/java/javase/9-deprecated-features-3745636.html#JDK-8184998){:target="_blank"}.
-As such, we no longer utilize WebStart.
+* Java 8 or later is required to use the library.
+* Starting with version 5.10.0, Java 17 is required to build the library.
 
 ## Quick Navigation
+* [Summary of changes for v5.10.x](#netcdf-java-api-changes-510x)
 * [Summary of changes for v5.9.x](#netcdf-java-api-changes-59x)
 * [Summary of changes for v5.8.x](#netcdf-java-api-changes-58x)
 * [Summary of changes for v5.7.x](#netcdf-java-api-changes-57x)
@@ -32,13 +24,22 @@ As such, we no longer utilize WebStart.
 * [Summary of changes for v5.1.x](#netcdf-java-api-changes-51x)
 * [Summary of changes for v5.0.x](#netcdf-java-api-changes-50x)
 
+## netCDF-Java API Changes (5.10.x)
+
+Point release notes:
+* [5.10.0](https://github.com/Unidata/netcdf-java/releases/tag/v5.10.0){:target="_blank"} (_yyyy-mm-dd, unreleased_)
+
+Starting with 5.10.x, the netCDF-Java library requires Java 17 to build (although the build will produce Java 8 bytecode, so the minimum supported version is still Java 8).
+Note: we are looking to update the minimum version of the JVM we support for the project.
+Please consider taking a moment to participate in the [poll on GitHub](https://github.com/Unidata/netcdf-java/discussions/1468){:target="_blank"}.
+
 ## netCDF-Java API Changes (5.9.x)
 
 Point release notes:
 * [5.9.0](https://github.com/Unidata/netcdf-java/releases/tag/v5.9.0){:target="_blank"} (_2025-08-08_)
 * [5.9.1](https://github.com/Unidata/netcdf-java/releases/tag/v5.9.1){:target="_blank"} (_2025-09-09_)
 
-The 5.9.x includes bug fixes around zarr support, scaling of projection parameters, and setting of the library path for the netCDF-C library.
+The 5.9.x release includes bug fixes around zarr support, scaling of projection parameters, and setting of the library path for the netCDF-C library.
 Additionally, udunits grammar code is now generated at build time, HTTP errors when disambiguating http/https locations has been improved, and scanning for filter providers is done once during initialization.
 EnhancementProviders are now loaded upon VariableDS instantiation, fixing a critical multithreaded environment related bug.
 Several ToolsUI improvements have been made as well.
@@ -184,6 +185,16 @@ Remove usages of `org.joda.time` outside of `ucar.nc2.time`.
 
 ## netCDF-Java API Changes (5.0.x)
 
+### Overview
+
+A number of API enhancements have been made to take advantage of evolution in the Java language, for example _try-with-resource_ and _foreach_ constructs.
+The use of these make code simpler and more reliable.
+
+Deprecated classes and methods have been removed, and the module structure and third-party jar use has been improved.
+
+Java WebStart has been deprecated as of [Java 9](https://www.oracle.com/technetwork/java/javase/9-deprecated-features-3745636.html#JDK-8184998){:target="_blank"}.
+As such, we no longer utilize WebStart.
+
 Point release notes:
 * [5.0.0](https://github.com/Unidata/netcdf-java/releases/tag/v5.0.0){:target="_blank"} (_2019-07-29_)
 

docs/src/site/pages/netcdfJava_tutorial/overview/BuildingFromSource.md

@@ -1,6 +1,6 @@
 ---
 title: Building From Source
-last_updated: 2025-08-08
+last_updated: 2025-10-30
 sidebar: netcdfJavaTutorial_sidebar
 permalink: building_from_source.html
 toc: false
@@ -10,9 +10,12 @@ toc: false
 
 The netCDF-Java source code is hosted on GitHub, and — as of v4.6.1 — we use Gradle to build it.
 Ant and Maven builds are no longer supported.
-To build, you need Git and JDK 8, JDK 11, or JDK 14 installed.
+To build, you need Git and, as of v5.9.2, Java 17 or higher (required for Gradle 9.0.0 or higher).
+Note that the bytecode produced by the Gradle build will be compatible with Java 8, and the test task will run using JDK 8 (thanks to the Gradle Toolchain feature).
+If the build cannot find a suitable JDK for testing, you will need to specify one in your `gradle.properties` file (see the [Gradle toolchain documentation](https://docs.gradle.org/current/userguide/toolchains.html#sec:custom_loc){:target="_blank"} for more details).
+The tests can be run using other JDK versions using `testX`, where `X` is the version number of one of the LTS releases of Java (currently `11`, `17`, `21`, or `25`).
 
-First, clone the netCDF-Java repository from Github:
+First, clone the netCDF-Java repository from GitHub:
 
 ~~~bash
 git clone -o unidata https://github.com/Unidata/netcdf-java.git netcdf-java

gradle/libs.versions.toml

@@ -1,5 +1,5 @@
 [versions]
-netcdf-java = "5.9.2-SNAPSHOT"
+netcdf-java = "5.10.0-SNAPSHOT"
 
 unidata-doc-theme = "0.0.6"