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 non-English PR flagging workflow #12934

Merged
merged 8 commits into from
May 20, 2024
Merged

feat: add non-English PR flagging workflow #12934

merged 8 commits into from
May 20, 2024

Conversation

wackerow
Copy link
Member

@wackerow wackerow commented May 8, 2024

Description

  • Adds a workflow that runs on all PRs
  • If PR has any files that touch non-English content (markdown or json) it will proceed
  • If above changes seen, the PR is labeled with "blocked" and "non-crowdin translation updates"
  • A comment is added, mentioning the author, directing to more information about the translation program, as well as a direct link to Crowdin requesting them to make these suggestion on that platform.
  • (Updates branch names used in Crowdin CI/CD imports to include crowdin; this allows us to easily ignore those branches)

Summary by CodeRabbit

  • New Features

    • Implemented a GitHub Actions workflow to check for non-English content updates and guide contributors to use Crowdin for translations.
  • Improvements

    • Updated branch naming convention for locale translation pull requests to include a "crowdin-" prefix for better identification.

@github-actions github-actions bot added needs review 👀 tooling 🔧 Changes related to tooling of the project labels May 8, 2024
Copy link

netlify bot commented May 8, 2024

Deploy Preview for ethereumorg ready!

Name Link
🔨 Latest commit 7e1ab4b
🔍 Latest deploy log https://app.netlify.com/sites/ethereumorg/deploys/66460bdd83400a0008ec01ff
😎 Deploy Preview https://deploy-preview-12934--ethereumorg.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
7 paths audited
Performance: 48 (🔴 down 8 from production)
Accessibility: 92 (no change from production)
Best Practices: 89 (🔴 down 9 from production)
SEO: 95 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify site configuration.

Should only match markdown and JSON files, excluding all English JSONs.
with:
github-token: ${{secrets.GITHUB_TOKEN}}
script: |
const prNumber = context.issue.number;
Copy link
Member Author

Choose a reason for hiding this comment

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

(GitHub treats PR's as a type of issue)

Copy link
Member Author

Choose a reason for hiding this comment

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

context made available from the Octokit package, which is automatically made available with actions/github-script@v5

Comment on lines +3 to +8
on:
pull_request:
paths:
- "public/content/translations/**/*.md"
- "src/intl/**/*.json"
- "!src/intl/en/**
Copy link
Member Author

@wackerow wackerow May 8, 2024

Choose a reason for hiding this comment

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

Will check every PR for changes to these paths. If any file in the diff includes:

  • a markdown file within public/content/translations or
  • a JSON file within src/intl (but NOT in src/intl/en)

the job will run.

Copy link
Member Author

Choose a reason for hiding this comment

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

Only .md and .json; images and other files could be updated separately without Crowdin.

Comment on lines +14 to +19
- name: Exit early if branch name contains 'crowdin'
run: |
if [[ "${{ github.head_ref }}" == *crowdin* ]]; then
echo "Branch name contains 'crowdin', stopping workflow"
exit 1
fi
Copy link
Member Author

Choose a reason for hiding this comment

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

Exits if crowdin is found in the branch name. The utils.ts update in this PR includes the addition of this string segment to the branch names generated in the Crowdin CI flow, so these will not be flagged.

Copy link
Member Author

Choose a reason for hiding this comment

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

Exiting with 1 (a non-zero status) will be seen as a "failure" and cause the following job to not run.

fi

add_label_and_comment:
needs: check_branch_name
Copy link
Member Author

Choose a reason for hiding this comment

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

Only if the branch is not a crowdin branch will this run

@wackerow wackerow changed the title Non english prs feat: add non-English PR flagging workflow May 8, 2024
@wackerow
Copy link
Member Author

Placing back in draft while I investigate a way to ignore href changes (ie, batch dead-link repairs do not need to be done through Crowdin first for the sake of patching).

@wackerow wackerow marked this pull request as draft May 13, 2024 10:59
@wackerow
Copy link
Member Author

wackerow commented May 13, 2024

Challenging to find a clean approach to identifying that only href values were changed. Instead, patched with an update to identify if the changed lines at least include the string segment href, and to flag these with a "question" label instead of "blocked" label, altering the PR comment accordingly.

This still needs some testing; keeping in draft in the meantime

  • Test workflow?

@wackerow wackerow marked this pull request as ready for review May 15, 2024 13:17
Copy link
Contributor

@minimalsm minimalsm left a comment

Choose a reason for hiding this comment

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

Looks great, two nitpicks but your call. LGTM

Comment on lines 60 to 61
const commentWithoutHrefs = `This pull request contains changes to non-English content, which must be handled through the Crowdin platform instead of GitHub.`
const commentWithHrefs = `This pull request contains changes to non-English content files, which may need to be handled through the Crowdin platform instead of GitHub.
Copy link
Contributor

Choose a reason for hiding this comment

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

We don't want people to see this comment and close their PR, what do you think of adding this?

Suggested change
const commentWithoutHrefs = `This pull request contains changes to non-English content, which must be handled through the Crowdin platform instead of GitHub.`
const commentWithHrefs = `This pull request contains changes to non-English content files, which may need to be handled through the Crowdin platform instead of GitHub.
const commentWithoutHrefs = `This pull request contains changes to non-English content, which must also be handled through the Crowdin platform instead of GitHub.`
const commentWithHrefs = `This pull request contains changes to non-English content files, which may also need to be handled through the Crowdin platform instead of GitHub.

Copy link
Member Author

Choose a reason for hiding this comment

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

Sure! Just would also change "instead of GitHub." to "instead of only on GitHub." (or something similar)

.github/workflows/non-english-warning.yml Outdated Show resolved Hide resolved
@minimalsm
Copy link
Contributor

@coderabbitai review

Copy link
Contributor

coderabbitai bot commented May 15, 2024

Actions Performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

Copy link
Contributor

coderabbitai bot commented May 15, 2024

Walkthrough

The recent updates introduce a GitHub Actions workflow to monitor non-English content updates and enforce the use of Crowdin for translations. Additionally, a minor adjustment was made to the branch naming convention in the locale translation pull request function, adding a "crowdin-" prefix for clearer identification.

Changes

Files Change Summary
.github/workflows/non-english-warning.yml Introduced a workflow to check for non-English updates outside Crowdin, directing contributors to use Crowdin for translations.
src/scripts/crowdin/translations/utils.ts Updated the branch name creation in the locale translation PR function to include a "crowdin-" prefix.

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

Share
Tips

Chat

There are 3 ways to chat with CodeRabbit:

Note: Auto-reply has been disabled for this repository by the repository owner. The CodeRabbit bot will not respond to your replies unless it is explicitly tagged.

  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai generate interesting stats about this repository and render them as a table.
    • @coderabbitai show all the console.log statements in this repository.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (invoked as PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger a review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai help to get help.

Additionally, you can add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.

CodeRabbit Configration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

.github/workflows/non-english-warning.yml Outdated Show resolved Hide resolved
.github/workflows/non-english-warning.yml Outdated Show resolved Hide resolved
wackerow and others added 2 commits May 15, 2024 16:54
Co-authored-by: Joshua <62268199+minimalsm@users.noreply.github.com>
Copy link
Contributor

@minimalsm minimalsm left a comment

Choose a reason for hiding this comment

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

LGTM

@wackerow wackerow merged commit 18b97ac into dev May 20, 2024
6 checks passed
@wackerow wackerow deleted the non-english-prs branch May 20, 2024 12:22
@corwintines corwintines mentioned this pull request May 22, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
tooling 🔧 Changes related to tooling of the project
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants