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: add workflow to test readme generation #6359

Open
wants to merge 22 commits into
base: master
Choose a base branch
from

Conversation

virajbhartiya
Copy link

Description

Created a workflow to search for README.docify.md in the repo, and run cargo build --features generate-readme in the dir of the file (assuming it is related to a crate). If the git diff shows some output for the README.md, then the file update wasn't pushed on the branch, and the workflow fails.
Closes #6331

Integration

Downstream projects that want to adopt this README checking workflow should:

  1. Copy the .github/workflows/readme-check.yml file to their repository
  2. Ensure any README.docify.md files in their project follow the expected format
  3. Implement the generate-readme feature flag in their Cargo.toml if not already present

Review Notes

This PR adds a GitHub Actions workflow that automatically verifies README.md files are up-to-date with their corresponding README.docify.md sources. Key implementation details:

  • The workflow runs on both PRs and pushes to main
  • It finds all README.docify.md files recursively in the repository
  • For each file found:
    • Builds the project with --features generate-readme in that directory
    • Checks if the README.md has any uncommitted changes
    • Fails if any README.md is out of sync

@virajbhartiya virajbhartiya requested review from a team as code owners November 5, 2024 05:41
@cla-bot-2021
Copy link

cla-bot-2021 bot commented Nov 5, 2024

User @virajbhartiya, please sign the CLA here.

@virajbhartiya virajbhartiya changed the title add workflow feat: add workflow to test readme generation Nov 5, 2024
.github/workflows/readme-check.yml Outdated Show resolved Hide resolved
.github/workflows/readme-check.yml Outdated Show resolved Hide resolved
.github/workflows/readme-check.yml Outdated Show resolved Hide resolved
@virajbhartiya
Copy link
Author

I have made the changes according to the give code review, please do give it a look and let me know if any other changes are required

.github/workflows/readme-check.yml Outdated Show resolved Hide resolved
.github/workflows/readme-check.yml Outdated Show resolved Hide resolved
@virajbhartiya
Copy link
Author

Could you please help me out with the 'check-prdoc' and 'check-labels' CI failure

Copy link
Contributor

@alvicsam alvicsam left a comment

Choose a reason for hiding this comment

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

Thanks for the PR! Requested some changes and also please add this jobs to the checks-quick.yml workflow file before the confirm-required-checks-quick-jobs-passed job instead of creating a new workflow file.

.github/workflows/readme-check.yml Outdated Show resolved Hide resolved
.github/workflows/readme-check.yml Outdated Show resolved Hide resolved
.github/workflows/readme-check.yml Outdated Show resolved Hide resolved
.github/workflows/readme-check.yml Outdated Show resolved Hide resolved
@alvicsam alvicsam added the R0-silent Changes should not be mentioned in any release notes label Nov 7, 2024
@paritytech-review-bot paritytech-review-bot bot requested a review from a team November 7, 2024 15:55
Copy link
Contributor

@iulianbarbu iulianbarbu left a comment

Choose a reason for hiding this comment

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

Hey @virajbhartiya ! Thanks a lot of addressing the previous rounds of feedback. We're almost there in terms of merging. Would be great to address what @alvicsam mentioned here: #6359 (review) too (meaning moving the job under checks-quick.yml, right before confirm-requried-checks-quick-jobs-passed, and I would add to also add it to the needs list of the same job).

.github/workflows/readme-check.yml Outdated Show resolved Hide resolved
.github/workflows/readme-check.yml Outdated Show resolved Hide resolved
.github/workflows/readme-check.yml Outdated Show resolved Hide resolved
.github/workflows/readme-check.yml Outdated Show resolved Hide resolved
.github/scripts/check-missing-readme-generation.sh Outdated Show resolved Hide resolved
Copy link
Contributor

@iulianbarbu iulianbarbu left a comment

Choose a reason for hiding this comment

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

Works great, thank you @virajbhartiya !

Copy link

Review required! Latest push from author must always be reviewed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
R0-silent Changes should not be mentioned in any release notes
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Create CI workflow that checks README.docify.md's are in sync with README.mds
3 participants