Skip to content

feat: add docs check to pull requests#2

Closed
dalelane wants to merge 1 commit into
masterfrom
gha-pr-docs-check
Closed

feat: add docs check to pull requests#2
dalelane wants to merge 1 commit into
masterfrom
gha-pr-docs-check

Conversation

@dalelane

@dalelane dalelane commented Jul 6, 2026

Copy link
Copy Markdown
Owner

Adding a new workflow to make sure docs aren't broken as part of the Github Actions CI pipeline for pull requests.

The goal is to achieve parity with the docs_404_check job that is included in the ci stage of the Azure Pipelines
azure-pipelines.yml which I'm treating as a reference implementation.


Example of a successful run: https://github.com/dalelane/flink/actions/runs/28648668507

Adding a new workflow to make sure docs aren't broken as part of
the Github Actions CI pipeline for pull requests.

The goal is to achieve parity with the docs_404_check job that is
included in the ci stage of the Azure Pipelines
azure-pipelines.yml which I'm treating as a reference implementation.

Signed-off-by: Dale Lane <dale.lane@uk.ibm.com>

@XComp XComp left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

LGTM 👍

s3_secret_key: ${{ secrets.IT_CASE_S3_SECRET_KEY }}

docs_check:
name: "Docs 404 check"

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

We don't do a filtering here, hm? The docs check will always run, even if there were no docs changes. But I guess that's a minor thing. 🤔

I checked with Azure: We have the following two subsequent nightly runs:

The following command shows that we're not touching any docs code. Still, the docs check was performed in #20260716.4.

$ git log 7757f2c..eda168e --oneline --name-only
eda168ef69b [FLINK-40138][tests] Drive JUnit 5 lifecycle when generating migration test snapshots (#28739)
flink-test-utils-parent/flink-migration-test-utils/pom.xml
flink-test-utils-parent/flink-migration-test-utils/src/main/java/org/apache/flink/test/migration/JUnit5TestEnvironment.java
flink-test-utils-parent/flink-migration-test-utils/src/main/java/org/apache/flink/test/migration/SnapshotGeneratorUtils.java

So, let's prepare the create a dedicated Jira subtask (with the context) and prepare this PR to make it mergable.

@dalelane

Copy link
Copy Markdown
Owner Author

@dalelane dalelane closed this Jul 17, 2026
@dalelane
dalelane deleted the gha-pr-docs-check branch July 17, 2026 12:42
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