Skip to content

Latest commit

 

History

History
59 lines (42 loc) · 2.52 KB

CONTRIBUTING.md

File metadata and controls

59 lines (42 loc) · 2.52 KB
Raw

Contributing

I welcome bug reports, feedbacks and ebuild feature requests; you can use the GitHub issue tracker or e-mail to provide them.

Code contributions and bug fixes are welcome too, and I encourage the use of merge requests to discuss and review your ebuild code changes. Before proposing a large change, please discuss it by raising an issue.

Before You Begin

This overlay assumes that you have read and properly understood the Gentoo Developer Manual.

Making and Submitting Changes

To make the process of merge requests submission as seamless as possible, I ask for the following:

  1. Go ahead and fork this project.

  2. Create your feature branch: git checkout -b my-new-feature develop

  3. When your code changes are ready, make sure to run repoman manifest, repoman full and pkgcheck scan in the package directory to ensure that all the Gentoo's QA tests pass. This is necessary to assure that nothing was accidentally broken by your changes; for the purpose this project integrates GitHub Actions for repoman, pkgcheck and shellcheck tests.

  4. Make sure your git commit messages are in the proper format to make reading history easier. Commit your message with repoman commit, which should look like:

    category/package-name: short description

Long description

    If you have questions about how to write the short/long descriptions, please read these blog articles: How to Write a Commit Message, 5 Useful Tips For A Better Commit Message. Both of them are excellent resources for learning how to write a well-crafted git commit message.

  5. GPG signing your changes is a good idea, but not mandatory.

  6. Push your changes in your fork git push origin my-new-feature, and then submit a pull request.

    Note: If you get in trouble with shellcheck's tests, please see their checks guide.

  7. Squash your commits into a single one with git rebase -i. It's okay to force update your merge request.