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

check mkdocs build strict in CI #1360

Merged
merged 3 commits into from
Nov 22, 2024

Conversation

kevinjqliu
Copy link
Contributor

@kevinjqliu kevinjqliu commented Nov 21, 2024

This PR adds a new GitHub Action to run mkdocs build --strict for every PR.

  • python-ci-docs.yml was previously used to release doc changes, it's copied over and renamed to python-release-docs.yml.
  • python-ci-docs.yml now runs mkdocs build --strict for every PR.

When releasing docs, the python-ci-docs.yml GitHub Action uses --strict. This action is only triggered during the release process, which requires an ad-hoc fix, see #1334.

run: mkdocs build --strict

Lets make sure this is checked in new PRs

Copy link
Contributor

@Fokko Fokko left a comment

Choose a reason for hiding this comment

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

Good one to check, I left some suggestions. Let me know what you think!

pyproject.toml Outdated Show resolved Hide resolved
.github/workflows/python-ci.yml Outdated Show resolved Hide resolved
@kevinjqliu kevinjqliu force-pushed the kevinjqliu/ci-check-mkdoc branch from 021e363 to aec8823 Compare November 22, 2024 00:03
Copy link
Contributor Author

Choose a reason for hiding this comment

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

renamed the old python-ci-docs.yml to python-release-docs.yml

Copy link
Contributor Author

Choose a reason for hiding this comment

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

this will now run on every PR when there's a change in mkdocs/docs/

@kevinjqliu kevinjqliu force-pushed the kevinjqliu/ci-check-mkdoc branch from 9d24bc4 to 13e558c Compare November 22, 2024 00:12
@kevinjqliu
Copy link
Contributor Author

verified that CI breaks with bad doc changes https://github.com/apache/iceberg-python/actions/runs/11963956201/job/33355402732?pr=1360

Copy link
Contributor

@Fokko Fokko left a comment

Choose a reason for hiding this comment

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

Thanks @kevinjqliu for fixing this, this looks great!

@kevinjqliu kevinjqliu closed this Nov 22, 2024
@kevinjqliu kevinjqliu force-pushed the kevinjqliu/ci-check-mkdoc branch from 13e558c to 7a83695 Compare November 22, 2024 16:27
@kevinjqliu kevinjqliu reopened this Nov 22, 2024
@kevinjqliu kevinjqliu merged commit 6316900 into apache:main Nov 22, 2024
13 of 18 checks passed
@kevinjqliu kevinjqliu deleted the kevinjqliu/ci-check-mkdoc branch November 22, 2024 16:39
sungwy pushed a commit to sungwy/iceberg-python that referenced this pull request Dec 7, 2024
* add ci to release docs

* run mkdocs in ci

* use 3.12
sungwy pushed a commit to sungwy/iceberg-python that referenced this pull request Dec 7, 2024
* add ci to release docs

* run mkdocs in ci

* use 3.12
JE-Chen pushed a commit to JE-Chen/iceberg-python that referenced this pull request Dec 23, 2024
* add ci to release docs

* run mkdocs in ci

* use 3.12
sungwy pushed a commit to sungwy/iceberg-python that referenced this pull request Dec 24, 2024
* add ci to release docs

* run mkdocs in ci

* use 3.12
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