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

feat: Publishes mdbook to Github Pages #4343

Merged
merged 2 commits into from
Jan 8, 2024
Merged

feat: Publishes mdbook to Github Pages #4343

merged 2 commits into from
Jan 8, 2024

Conversation

maddeleine
Copy link
Contributor

@maddeleine maddeleine commented Jan 3, 2024

Resolved issues:

N/A

Description of changes:

Publishes our usage guide mdbook to our github pages branch. I basically just copied s2n-quic's mdbook publish workflow, so you can find a preview of the book if you click on the github action: "book / url"

Callouts

This workflow will not run if you are opening a PR from a fork of s2n-tls. I'd rather keep s2n-tls and s2n-quic in sync than fix this problem, but it should be noted that PRs from forks won't have the preview.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

@github-actions github-actions bot added the s2n-core team label Jan 3, 2024
@maddeleine maddeleine marked this pull request as ready for review January 4, 2024 18:56
Copy link
Contributor

@dougch dougch left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I sort of arbitrarily chose to do this site update when a PR is merged, rather than each time a PR is updated. I just don't think we need that much fidelity for documentation changes, but I'm open to other opinions.

This is reasonable and how were doing the others.

@maddeleine maddeleine removed the request for review from lrstewart January 4, 2024 21:46
@dougch dougch self-requested a review January 8, 2024 17:39
aws-region: us-west-1

- name: Upload to S3
if: github.event_name == 'push' || github.repository == github.event.pull_request.head.repo.full_name
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

right- not publishing to s3 for external forks.

Copy link
Contributor

@dougch dougch left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Much cleaner- lgtm with the caveat that we note the permissions required for docs to make it to S3.

@maddeleine maddeleine merged commit 51c49fd into main Jan 8, 2024
32 checks passed
@maddeleine maddeleine deleted the mdbook_publish branch January 8, 2024 18:30
dougch pushed a commit to dougch/s2n-tls that referenced this pull request Jan 17, 2024
This was referenced Mar 14, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants