From ddc80bafdbb0cbd084691617cc6fa3c7f7925bdb Mon Sep 17 00:00:00 2001 From: grantbirki Date: Thu, 13 Apr 2023 23:01:41 +0100 Subject: [PATCH] add a CONTRIBUTING file --- CONTRIBUTING.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..afac2a7 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,32 @@ +# Contributing ๐Ÿ’ป + +All contributions are welcome and greatly appreciated! + +## Steps to Contribute ๐Ÿ’ก + +> Check the `.node-version` file in the root of this repo so see what version of Node.js is required for local development - note, this can be different from the version of Node.js which runs the Action on GitHub runners. It is suggested to download [nodenv](https://github.com/nodenv/nodenv) which uses this file and manages your Node.js versions for you + +1. Fork this repository +2. Commit your changes +3. Test your changes (learn how to test below) +4. Open a pull request back to this repository +5. Notify the maintainers of this repository for peer review and approval +6. Merge! + +The maintainers of this repository will create a new release with your changes so that everyone can use the new release and enjoy the awesome features of this Action! + +## Testing ๐Ÿงช + +This project requires **100%** test coverage + +> The deploy-pages Action is used by enterprises, governments, and open source organizations - it is critical that we have 100% test coverage to ensure that we are not introducing any regressions. All changes will be throughly tested by maintainers of this repository before a new release is created. + +### Running the test suite (required) + +Simply run the following command to execute the entire test suite: + +```bash +npm run test +``` + +> Note: this requires that you have already run `npm install`