Skip to content

Update latest docs symlink and improve 1.0.0 release notes#866

Merged
jormundur00 merged 2 commits into
masterfrom
jormundur00/gh-863
Apr 9, 2026
Merged

Update latest docs symlink and improve 1.0.0 release notes#866
jormundur00 merged 2 commits into
masterfrom
jormundur00/gh-863

Conversation

@jormundur00

Copy link
Copy Markdown
Member

Summary

  • automatically refresh the documentation latest symlink during release publishes while leaving snapshot publishes untouched
  • improve the changelog for 1.0.0 so the release notes call out the metadata format change and the compatibility caveat reported after release

Changes

  • update the documentation publish plugin to detect the final docs version after project evaluation instead of reading Gradle's initial unspecified value
  • keep publishing the versioned docs directory as before, but recreate latest explicitly as a symlink on release publishes only
  • leave latest unchanged for -SNAPSHOT publishes so master docs do not overwrite the latest released docs
  • add a 1.0.1 changelog entry for the automatic latest symlink refresh
  • add a 1.0.0 changelog entry describing the reachability metadata 1.0 transition and the Spring Boot/Hibernate Validator compatibility caveat

Verification

  • JAVA_HOME="$HOME/.sdkman/candidates/java/17.0.12-graal" PATH="$JAVA_HOME/bin:$PATH" ./gradlew :docs:gitPublishReset :docs:gitPublishCopy
    • confirmed snapshot publishing leaves docs/build/gitPublish/latest -> 0.11.1 unchanged
  • JAVA_HOME="$HOME/.sdkman/candidates/java/17.0.12-graal" PATH="$JAVA_HOME/bin:$PATH" ./gradlew -PpublishVersion=1.0.1 :docs:gitPublishReset :docs:gitPublishCopy
    • confirmed release publishing rewrites docs/build/gitPublish/latest -> 1.0.1
  • JAVA_HOME="$HOME/.sdkman/candidates/java/17.0.12-graal" PATH="$JAVA_HOME/bin:$PATH" ./gradlew :docs:asciidoctor
    • succeeds; only the existing Asciidoctor warnings remain

Fixes: #863, #862

@oracle-contributor-agreement oracle-contributor-agreement Bot added the OCA Verified All contributors have signed the Oracle Contributor Agreement. label Apr 6, 2026
@jormundur00 jormundur00 self-assigned this Apr 6, 2026
@jormundur00 jormundur00 marked this pull request as ready for review April 6, 2026 08:39
@jormundur00 jormundur00 requested a review from vjovanov April 6, 2026 08:39
@jormundur00 jormundur00 added the bug Something isn't working label Apr 6, 2026
@jormundur00 jormundur00 merged commit 4d614c7 into master Apr 9, 2026
1 check passed
@jormundur00 jormundur00 deleted the jormundur00/gh-863 branch April 9, 2026 08:00
mergify Bot added a commit to robfrank/linklift that referenced this pull request May 3, 2026
…1.5 to 1.1.0 [skip ci]

Bumps [org.graalvm.buildtools:native-maven-plugin](https://github.com/graalvm/native-build-tools) from 0.11.5 to 1.1.0.
Release notes

*Sourced from [org.graalvm.buildtools:native-maven-plugin's releases](https://github.com/graalvm/native-build-tools/releases).*

> 1.1.0
> -----
>
> What's Changed
> --------------
>
> * Release 1.0.0 by [`@​graalvmbot`](https://github.com/graalvmbot) in [graalvm/native-build-tools#857](https://redirect.github.com/graalvm/native-build-tools/pull/857)
> * Bump version to 1.0.1-SNAPSHOT by [`@​graalvmbot`](https://github.com/graalvmbot) in [graalvm/native-build-tools#858](https://redirect.github.com/graalvm/native-build-tools/pull/858)
> * Use a safer way to create the temporary access filter file by [`@​sschuberth`](https://github.com/sschuberth) in [graalvm/native-build-tools#852](https://redirect.github.com/graalvm/native-build-tools/pull/852)
> * Bump io.netty:netty-codec-http from 4.1.129.Final to 4.1.132.Final in /samples/metadata-repo-integration by [`@​dependabot`](https://github.com/dependabot)[bot] in [graalvm/native-build-tools#859](https://redirect.github.com/graalvm/native-build-tools/pull/859)
> * Add class introduced in 5.14.1/6.0.1 by [`@​marcphilipp`](https://github.com/marcphilipp) in [graalvm/native-build-tools#794](https://redirect.github.com/graalvm/native-build-tools/pull/794)
> * Reduce CI usage by running CI only on "pull\_request" and running only the latest gradle version (except when creating a new release) by [`@​jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#861](https://redirect.github.com/graalvm/native-build-tools/pull/861)
> * Update latest docs symlink and improve 1.0.0 release notes by [`@​jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#866](https://redirect.github.com/graalvm/native-build-tools/pull/866)
> * Fix early classpath resolution in GenerateDynamicAccessMetadata by [`@​jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#868](https://redirect.github.com/graalvm/native-build-tools/pull/868)
> * Bump reachability metadata version to 1.0.0 by [`@​jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#879](https://redirect.github.com/graalvm/native-build-tools/pull/879)
> * Add listLibrariesMissingMetadata task/goal for Gradle and Maven by [`@​jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#877](https://redirect.github.com/graalvm/native-build-tools/pull/877)
>
> **Full Changelog**: <graalvm/native-build-tools@1.0.0...1.1.0>
>
> 1.0.0
> -----
>
> Breaking Changes
> ----------------
>
> * Native Build Tools 1.0.0 moves to the `1.0-M1` release of the reachability metadata repository, which uses the new `reachability-metadata.json` metadata format and no longer uses the global `metadata/index.json`.
> * This may require dependency and metadata updates in downstream projects; some stacks can regress until they adapt.
>
> What's Changed
> --------------
>
> * Fix broken JavaApplicationFunctionalTest due to using a removed feature by [`@​jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#850](https://redirect.github.com/graalvm/native-build-tools/pull/850)
> * Remove the usage of the global metadata/index.json from the nbt plugins by [`@​jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#829](https://redirect.github.com/graalvm/native-build-tools/pull/829)
> * Add reachability-metadata-schema cross-validation by [`@​jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#840](https://redirect.github.com/graalvm/native-build-tools/pull/840)
> * Merge 1.0-M1 branch to master by [`@​jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#848](https://redirect.github.com/graalvm/native-build-tools/pull/848)
>
> **Full Changelog**: <graalvm/native-build-tools@0.11.5...1.0.0>


Commits

* [`84cc046`](graalvm/native-build-tools@84cc046) Release 1.1.0
* [`95512d0`](graalvm/native-build-tools@95512d0) Add listLibrariesMissingMetadata task/goal for Gradle and Maven ([#877](https://redirect.github.com/graalvm/native-build-tools/issues/877))
* [`0dcda78`](graalvm/native-build-tools@0dcda78) Merge pull request [#879](https://redirect.github.com/graalvm/native-build-tools/issues/879) from jormundur00/bump-metadata-repository-1.0.0
* [`e5b90f0`](graalvm/native-build-tools@e5b90f0) Bump reachability metadata version to 1.0.0
* [`05f45d3`](graalvm/native-build-tools@05f45d3) Fix early classpath resolution in GenerateDynamicAccessMetadata ([#868](https://redirect.github.com/graalvm/native-build-tools/issues/868))
* [`4d614c7`](graalvm/native-build-tools@4d614c7) Update latest docs symlink and improve 1.0.0 release notes ([#866](https://redirect.github.com/graalvm/native-build-tools/issues/866))
* [`ee1351d`](graalvm/native-build-tools@ee1351d) Reduce CI usage by running CI only on "pull\_request" and running only the lat...
* [`c6f3674`](graalvm/native-build-tools@c6f3674) Add class introduced in 5.14.1/6.0.1 ([#794](https://redirect.github.com/graalvm/native-build-tools/issues/794))
* [`5bc69bd`](graalvm/native-build-tools@5bc69bd) Bump io.netty:netty-codec-http from 4.1.129.Final to 4.1.132.Final in /sample...
* [`395f3b2`](graalvm/native-build-tools@395f3b2) Use a safer way to create the temporary access filter file ([#852](https://redirect.github.com/graalvm/native-build-tools/issues/852))
* Additional commits viewable in [compare view](graalvm/native-build-tools@0.11.5...1.1.0)
  
[![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility\_score?dependency-name=org.graalvm.buildtools:native-maven-plugin&package-manager=maven&previous-version=0.11.5&new-version=1.1.0)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)
Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting `@dependabot rebase`.
[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)
---
Dependabot commands and options
  
You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it
- `@dependabot show  ignore conditions` will show all of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working OCA Verified All contributors have signed the Oracle Contributor Agreement.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Documentation latest/ page is not actually the latest version

2 participants