setup-python/docs/contributors.md

32 lines
1.4 KiB
Markdown
Raw Normal View History

2019-08-20 21:27:52 +07:00
# Contributors
### Checkin
2019-12-27 23:26:49 +07:00
- Do check in source (src)
- Do check in a single index.js file after running `ncc`
- Do not check in node_modules
2019-08-20 21:27:52 +07:00
2019-11-08 03:26:27 +07:00
### NCC
2019-08-20 21:27:52 +07:00
2019-11-08 03:26:27 +07:00
In order to avoid uploading `node_modules` to the repository, we use [zeit/ncc](https://github.com/zeit/ncc) to create a single `index.js` file that gets saved in `dist/`.
2019-08-20 21:27:52 +07:00
2019-11-08 03:26:27 +07:00
### Developing
2019-12-27 23:26:49 +07:00
If you're developing locally, you can run
2019-08-20 21:27:52 +07:00
```
2019-11-08 03:26:27 +07:00
npm install
tsc
ncc build
2019-08-20 21:27:52 +07:00
```
2019-11-25 20:46:36 +07:00
Any files generated using `tsc` will be added to `lib/*`, however those files also are not uploaded to the repository and are exluded using `.gitignore`.
2019-11-08 03:26:27 +07:00
During the commit step, Husky will take care of formatting all files with [Prettier](https://github.com/prettier/prettier)
### Testing
2019-08-20 21:27:52 +07:00
2019-12-27 23:26:49 +07:00
We ask that you include a link to a successful run that utilizes the changes you are working on. For example, if your changes are in the branch `newAwesomeFeature`, then show an example run that uses `setup-python@newAwesomeFeature` or `my-fork@newAwesomeFeature`. This will help speed up testing and help us confirm that there are no breaking changes or bugs.
2019-12-23 23:05:45 +07:00
### Releases
There is a `master` branch where contributor changes are merged into. There are also release branches such as `releases/v1` that are used for tagging (for example the `v1` tag) and publishing new versions of the action. Changes from `master` are periodically merged into a releases branch. You do not need to create any PR that merges changes from master into a releases branch.