diff --git a/CONTRIBUTION.md b/CONTRIBUTION.md new file mode 100644 index 00000000..9311d8fc --- /dev/null +++ b/CONTRIBUTION.md @@ -0,0 +1,12 @@ +# How to contribute to HyperCPU project + +## For collaborators: + +1. Clone repository locally +2. Create new branch from the branch `master`. Think about the name - what feature are you going to add? Or are you going to fix something? +3. Work on that branch, DO NOT touching others. Every push in a non-master branch runs a CI workflow with minimal tests. +4. When the feature is ready - make a pull request to the master branch. When the PR gets created, you have to track following checks: `CodeQL`, `Codacy`, main CI workflow, that runs extended tests, and the job that builds the project on multiple distributions. Wait for the project owner to review changes and approve. In case, if MentatBot will tell you what you can improve - you better improve it:) When all CI jobs will finish successfully, wait for repository owner to merge your PR. Voila - your feature has been merged! Well done! + +## For other contributors + +1. Almost the same thing as for collabolators, BUT - you have to fork the repository, and work there. Notice, that you probably have to disable GitHub Actions, or connect the self-hosted runner (no guarantee that HyperCPU workflows will execute successfully on custom runner). When you are ready to send your changes - make a PR - and there goes the same cycle, until the PR gets merged:) \ No newline at end of file diff --git a/README.md b/README.md index 40d3280e..88f1ca79 100644 --- a/README.md +++ b/README.md @@ -142,21 +142,12 @@ To display program version and exit: $ ./hcemul --version ``` -### Build status -## Supported Distributions - -| Distribution | Build Status | -|-----------------|--------------| -| Fedora | [![Fedora Build Status](https://img.shields.io/github/actions/workflow/status/HyperWinX/HyperCPU/distro-ci.yml?label=Fedora&jobName=Build-Fedora)](https://github.com/HyperWinX/HyperCPU/actions/workflows/distro-ci.yml) | -| Debian Stable | [![Debian Stable Build Status](https://img.shields.io/github/actions/workflow/status/HyperWinX/HyperCPU/distro-ci.yml?label=Debian%20Stable&jobName=Build-Debian-Stable)](https://github.com/HyperWinX/HyperCPU/actions/workflows/distro-ci.yml) | -| Debian Unstable | [![Debian Unstable Build Status](https://img.shields.io/github/actions/workflow/status/HyperWinX/HyperCPU/distro-ci.yml?label=Debian%20Unstable&jobName=Build-Debian-Unstable)](https://github.com/HyperWinX/HyperCPU/actions/workflows/distro-ci.yml) | ### Contributing HyperCPU is in active development and we will be happy to hear any feedback from you. Do not hesitate to report bugs or suggest any ideas using "Issues" page. ->[!IMPORTANT] -> Please send your pull requests to `dev` repository branch, not `master`. +See how you can contribute in [CONTRIBUTION.MD](CONTRIBUTION.md). Thank you for your interest in HyperCPU.