mirror of
https://github.com/edgelesssys/constellation.git
synced 2024-12-27 08:29:33 -05:00
7dcd8c3dab
* refactor dev-docs structure and add information * improve doc * Update dev-docs/workflows/create-debug-cluster.md Co-authored-by: Daniel Weiße <66256922+daniel-weisse@users.noreply.github.com> * Update dev-docs/workflows/create-debug-cluster.md Co-authored-by: Daniel Weiße <66256922+daniel-weisse@users.noreply.github.com> * pr feedback daniel * Update dev-docs/README.md Co-authored-by: Daniel Weiße <66256922+daniel-weisse@users.noreply.github.com> * move to howto again * split up dev-setup and pull-request into sep files * fix backticks * add writing style convention + testing repo * remove OSS cluster + reduce plugins vs code * update bazel pre-pr doc * ghcr img private hint * add fetch measurement + provider sub-directory hint * add label doc + pr title check in template * add OSS build comment * Update CONTRIBUTING.md Co-authored-by: Thomas Tendyck <51411342+thomasten@users.noreply.github.com> * Update CONTRIBUTING.md Co-authored-by: Thomas Tendyck <51411342+thomasten@users.noreply.github.com> * Update dev-docs/README.md Co-authored-by: Thomas Tendyck <51411342+thomasten@users.noreply.github.com> * Update dev-docs/workflows/dev-setup.md Co-authored-by: Thomas Tendyck <51411342+thomasten@users.noreply.github.com> * thomas feedback * add go proverb mention --------- Co-authored-by: Daniel Weiße <66256922+daniel-weisse@users.noreply.github.com> Co-authored-by: Thomas Tendyck <51411342+thomasten@users.noreply.github.com>
60 lines
1.8 KiB
Markdown
60 lines
1.8 KiB
Markdown
# Pull Request (PR)
|
||
|
||
## Process
|
||
|
||
Submissions should remain focused in scope and avoid containing unrelated commits.
|
||
For pull requests, we employ the following workflow:
|
||
|
||
1. Fork the repository to your own GitHub account
|
||
2. Create a branch locally with a descriptive name
|
||
3. Commit changes to the branch
|
||
4. Write your code according to our development guidelines
|
||
5. Push changes to your fork
|
||
6. Clean up your commit history
|
||
7. Open a PR in our repository and summarize the changes in the description
|
||
|
||
### Major changes and feature requests
|
||
|
||
You should discuss larger changes and feature requests with the maintainers. Please open an issue describing your plans.
|
||
|
||
[Run CI e2e tests](github-actions.md)
|
||
|
||
## Conventions
|
||
|
||
### Title
|
||
|
||
Our changelog is generated from PR titles, so please stick to the naming convention.
|
||
|
||
The PR title should be structured in one of the following ways:
|
||
|
||
```
|
||
<module>: <title>
|
||
```
|
||
|
||
Where the `<module>` is
|
||
|
||
* the top level directory of the microservice or component, e.g., `joinservice`, `disk-mapper`, `upgrade-agent` but also `docs` and `rfc`
|
||
* in internal, the second level directory
|
||
* `deps` for dependency upgrades
|
||
* `ci` for things that are CI related
|
||
|
||
and `<title>` is all lower case (except proper names, including acronyms).
|
||
Ticket numbers shouldn’t be part of the title.
|
||
|
||
In case the scope of your PR is too wide, use the alternative format.
|
||
|
||
```
|
||
<Title>
|
||
```
|
||
|
||
and `<Title>` starts with a capital letter.
|
||
|
||
### Labels
|
||
|
||
The labels are used for changelog generation (targeted at constellation users), so select the label with this purpose in mind.
|
||
To exclude the PR from changelog only use these labels:
|
||
|
||
* `no changelog` / `dependencies`
|
||
|
||
The changelog generation is described [here](https://docs.github.com/en/repositories/releasing-projects-on-github/automatically-generated-release-notes). This is our configuration [release.yml](/.github/release.yml).
|