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

CI: check if docs need to be regenerated #362

Merged
merged 19 commits into from
Feb 4, 2021

Conversation

Integralist
Copy link
Collaborator

If a change is made to a schema Description field and a PR is opened, then we would like to be able to identify to the author of the PR that the documentation needs to be regenerated (e.g. by running make generate-docs).

The solution is to have a Github workflow which runs the relevant Makefile target and then runs git diff to see if there's any changes to what's in the main branch. If there are changes, it means new documentation files were generated in CI and so the author of the PR should run the relevant Makefile target locally and commit those changes.

@Integralist Integralist marked this pull request as ready for review February 3, 2021 14:41
@Integralist Integralist requested review from phamann, a team and kailan and removed request for a team February 3, 2021 14:41
@Integralist Integralist removed the request for review from kailan February 3, 2021 14:46
@Integralist Integralist requested review from a team and doramatadora and removed request for a team February 3, 2021 14:46
@Integralist
Copy link
Collaborator Author

@doramatadora @phamann ready for review.

Copy link
Member

@phamann phamann left a comment

Choose a reason for hiding this comment

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

👍🏻 LGTM - my comment is just for curiosity and not blocking.

GNUmakefile Show resolved Hide resolved
Copy link
Contributor

@doramatadora doramatadora left a comment

Choose a reason for hiding this comment

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

LGTM 🚀

@Integralist Integralist merged commit 0de8070 into master Feb 4, 2021
@Integralist Integralist added the enhancement New feature or request label Feb 4, 2021
@Integralist Integralist deleted the integralist/20210201_docs_ci branch February 4, 2021 11:13
@Integralist Integralist changed the title Check if docs need to be regenerated CI: check if docs need to be regenerated Feb 4, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants