Skip to content

Latest commit

 

History

History
32 lines (27 loc) · 1.72 KB

CONTRIBUTING.org

File metadata and controls

32 lines (27 loc) · 1.72 KB

How to Contribute

Thanks for considering contributing to this project, it would be amazing if that happened, and I’d be stoked to have your help! Here are a few guidelines to help smooth out this process and to get your changes into Clipetty ASAP.

Submit a Pull Request

Fork the project on Github, commit your changes to your fork’s master branch, and then submit a Pull Request. I’ll take a look, and we’ll have a conversation about your proposed changes in the PR. This is how most projects on Github work, and this one is no different.

Adding Tests

If your PR contains a non-trivial change or fixes a bug that the unit tests didn’t catch, it’d be great if you were to add one or more unit tests to clipetty-test.el.

Passing Tests

The script run-tests.sh is used by the CI workflow to make sure commits to master or new pull requests pass all the existing tests, including:

  • Ensuring the elisp byte-compiles cleanly
  • Ensuring that M-x checkdoc is happy
  • Ensuring that package-lint is happy
  • Ensuring that all the existing unit tests still pass

Some of these tests can be picky and annoying. My advice is to just make the linter happy and move on. You should probably run run-tests.sh manually yourself before submitting your PR so there aren’t any surprises.

Updating the Docs

The README.md file is generated from README.org using org-gfm-export-to-markdown, so if you’d like to suggest a change to the documentation, make sure to commit your change to the right place.