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

Add yarn build check to CI for the docs #1952

Closed
critesjosh opened this issue Sep 3, 2023 · 1 comment · Fixed by #1955
Closed

Add yarn build check to CI for the docs #1952

critesjosh opened this issue Sep 3, 2023 · 1 comment · Fixed by #1955

Comments

@critesjosh
Copy link
Contributor

We are not currently checking that updates to the docs dir are not breaking the build. If someone merges a breaking change, the dev docs site (https://aztec-docs-dev.netlify.app/) will not update.

Netlify has an integration that will notify of breaking builds, but it doesn't integrate nicely with a monorepo and would run against every single PR, not just updates to the docs, which would add unnecessary overhead. It's probably better for us to add this to our CI and only run against updates to the docs.

IIRC, @ludamad mentioned that branches prefixed with docs will run their own CI, but not sure if this is the case.

@github-project-automation github-project-automation bot moved this to Todo in A3 Sep 3, 2023
@ludamad
Copy link
Collaborator

ludamad commented Sep 3, 2023

That was a plan, currently not the case

iAmMichaelConnor pushed a commit that referenced this issue Sep 3, 2023
fixes: #1952
fixes: #1908

# Overview
Makes docs rebuild on every pr, the reason for this being that the pre
processor can reference ANY code. And we were not explicitly checking
that docs builds succeeded on prs.

It only takes 4 minutes to run, and runs in isolation, so its not too
bad to run each time.

## TODO
The docs were broken by some broken links that I have not expressly
fixed, but they can be forked from this and fixed
@github-project-automation github-project-automation bot moved this from Todo to Done in A3 Sep 3, 2023
AztecBot pushed a commit to AztecProtocol/docs that referenced this issue Sep 3, 2023
fixes: AztecProtocol/aztec-packages#1952
fixes: AztecProtocol/aztec-packages#1908

# Overview
Makes docs rebuild on every pr, the reason for this being that the pre
processor can reference ANY code. And we were not explicitly checking
that docs builds succeeded on prs.

It only takes 4 minutes to run, and runs in isolation, so its not too
bad to run each time.

## TODO
The docs were broken by some broken links that I have not expressly
fixed, but they can be forked from this and fixed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Archived in project
Development

Successfully merging a pull request may close this issue.

2 participants