Enable auto-publication of the spec to /TR #502
Merged
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
This update enables auto-publication of the spec as Candidate Recommendation Draft to /TR, as agreed by the working group. It leverages the spec-prod action to do that. This update also adjusts the workflow for the Editor's Draft itself. The source spec is now to be found in the `main` branch, and instead of publishing the source spec to GitHub Pages directly, the spec-prod action will rather deploy the generated spec. Among other things, this makes it possible to integrate the spec in Bikeshed's database for cross-referencing purpose. The spec-prod action also takes care of running ReSpec on pull requests to validate changes from an editorial perspective. Note the `ECHIDNA_TOKEN` has been added as secret to the repository.
The spec seems correct to me, but ReSpec complains that the `github` option should rather be used when it builds the Candidate Recommendation Draft. This reduces the number of links in the front matter in practice, which is a good thing.
anssiko
approved these changes
Apr 22, 2022
|
Looks like things are working from a quick glance. Thank you tor upgrading our publication flow @tidoust :-) |
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 update enables auto-publication of the spec as Candidate Recommendation Draft to /TR, as agreed by the working group. It leverages the spec-prod action to do that.
This update also adjusts the workflow for the Editor's Draft itself. The source spec is now to be found in the
mainbranch, and instead of publishing the source spec to GitHub Pages directly, the spec-prod action will rather deploy the generated spec. Among other things, this makes it possible to integrate the spec in Bikeshed's database for cross-referencing purpose.The spec-prod action also takes care of running ReSpec on pull requests to validate changes from an editorial perspective.
This approach replaces the former approach based on Travis CI.
Note the
ECHIDNA_TOKENwas added as secret to the repository.@mfoltzgoogle There is no good and easy way to test this. At worst, publication fails and I'll investigate and fix parameters that I may have missed. Also note the switch to
mainas the default branch that contains the source code.Preview | Diff