globocom / globocom/huskyCI

GitHub Actions for Automatic README Translation and Pull Request

Open
#574 2 comments 0 reactions 0 assignees View on GitHub
hacktoberfest
Dominant language
Go
Stars
595
Forks
135
PR merge metrics
No merged PRs in 30d

Description

1. **Problem Description:**
- The README file is currently only available in one language, and there is a need to make it accessible to a broader audience by providing translations.

2. **Steps to Reproduce:**
- N/A

3. **Expected Behavior:**
- Implement a GitHub Actions workflow that triggers whenever the README file receives a change. This workflow automatically translates the README into Portuguese and creates a pull request for code review and merge.

4. **Current Behavior:**
- The README is available in a single language, and the translation process is manual and time-consuming.

5. **Proposed Changes:**
- Set up a GitHub Actions workflow that listens for changes to the README file.
- On any change, automatically translate the README into Portuguese using a translation tool.
- Create a pull request with the translated README, ready for code review and merge.

6. **Dependencies:**
- GitHub Actions must be enabled for the repository.
- Access to a translation tool or service for automatic translation.

7. **Testing:**
- Test the GitHub Actions workflow by making changes to the README file and verifying that the translation and pull request creation processes are triggered automatically.

8. **Documentation Updates:**
- Update the project documentation to inform contributors and maintainers about the new GitHub Actions workflow.
- Provide information on the translation tool used and any considerations for translation accuracy.

9. **Expected Impact:**
- This GitHub Actions workflow will streamline the process of translating the README into Portuguese, making the project more accessible to a wider audience.

10. **Additional Information:**
- Consider setting up a review process for the translated content to ensure accuracy and appropriateness.
- Provide guidance for contributors on handling translations for future README changes.

**Note:** Ensure that the translation process adheres to quality standards, and consider involving native speakers or language experts in the review process.

Contributor guide

Open the contributing guide

Research direction

Start with the README and the repository's GitHub Actions configuration, then determine how a translation service and pull request creation can be connected securely. Done means README changes trigger a Portuguese translation and reviewable pull request, the workflow is tested end to end, and contributor documentation explains the tool and review process.

Written by the indexing model from the issue text.

Assessment

Tech stack
github-actions
Domain
ci-cd, documentation, localization
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.