TASK-4121 Also build JavaDocs, Maven Site, and upload the latter to Google Cloud #23
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…ing workflows Calling workflows may need to do additional tasks (like upload documentation) that require the just-released version number. By exporting this as a workflow output (cp. https://docs.github.com/en/actions/using-workflows/reusing-workflows#using-outputs-from-a-reusable-workflow), it doesn't need to be re-read, and an empty value signals that the revision was already tagged so no release actually happened.
This creates the project reports and JavaDoc. For MavenSetup itself, this isn't very useful in itself, but projects that reuse the workflow want to publish the site.
inkarkat
force-pushed
the
housekeeping/enh/export-version
branch
from
1fc4b59 to
edd6d14
Compare
The site information isn't that interesting for MavenSetup itself, but projects that reuse the workflow should publish their site, as it contains the JavaDocs and dependency information. If we'd delegate that to calling workflows, the site information would need to be cached or up/downloaded as artifacts because workspace files are not persisted across jobs.
A full site build would take too long, but it's useful to quickly verify the JavaDoc generation.
inkarkat
force-pushed
the
housekeeping/enh/export-version
branch
from
edd6d14 to
011be77
Compare
As we're still publishing the latest site. It's also good to do this in order to verify the site build.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This aligns the MavenSetup with what we've implemented in ReBuild, adding the JavaDoc build for feature branches (now that JuicyRaspberryPie additions have proper documentation), building the complete site reports, and uploading that to https://javadocs.dev.reload.works/
This allows users of the reusable workflow (like JuicyRaspberryPie, and eventually also plugins extracted from ReBuild) to publish their documentation.
TASK-NNNNprefix in the commit message subject@Deprecated