Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Publish HTML docs for 1.1 RTL in addition to main #676

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

jhand2
Copy link

@jhand2 jhand2 commented Dec 23, 2024

Currently the docs workflow only publishes documentation for registers at main. To make it easier to look up registers for 1.x, also publish the registers from the patch_v1.1 branch.

This was tested on my fork of this repo. See sample output:

Currently the docs workflow only publishes documentation for registers
at main. To make it easier to look up registers for 1.x, also publish
the registers from the patch_v1.1 branch.
@jhand2 jhand2 requested a review from Nitsirks December 23, 2024 20:26
@jhand2
Copy link
Author

jhand2 commented Dec 23, 2024

Not sure what I'm supposed to do to bypass the test timestamp, since this is a documentation-only change:

Latest non-doc hash is d5cfea9be870d8539efef4462eef4b564d01553e
Error, submitted timestamp [1734735334] is outdated: it precedes the latest non-documentation commit to branch by more than an hour [1734981795]
Please rerun any internal/company proprietary testcases, which should invoke .github/scripts/stamp_repo.sh to attest to successful completion
DO NOT manually run stamp_repo.sh on your branch to bypass this step - the output timestamp/hash is used to verify internal testcase sign-off is successful

@calebofearth
Copy link
Collaborator

calebofearth commented Dec 23, 2024

Thanks for doing this Jordan, nice improvement!
The hash check is firing because this PR modifies a yml file. The "doc-only" exception currently only applies to .md/.png files.
We could probably stand to except the workflow files as well - adding ! -path "*.github/workflows/* here: https://github.com/jhand2/caliptra-rtl/blob/docs_1_1/.github/workflows/pre-run-check.yml#L102 should do the trick.
A couple additional requests as part of this PR:

@calebofearth
Copy link
Collaborator

Also, a topic for discussion in the WG: Do we go back and retroactively update the README from patch_v1.1 to point to these new pages?
We could just directly update the release collateral https://github.com/chipsalliance/caliptra-rtl/releases/tag/v1.1

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants