Currently it’s done through custom Gradle tasks, but that gets in the way of changing where we publish our docs for all projects at the same time.

See https://github.com/hibernate/hibernate-release-scripts/blob/main/upload-documentation.sh
See use in Hibernate Search for example.

See https://hibernate.atlassian.net/browse/HHH-19800 for a similar task in Hibernate ORM.