blob: 5a975dbaef0b84171f9c07a083981b16bcdfb605 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
|
# Contributing
This is a personal Exherbo repository for packages I use. Issues and pull requests are welcome on [Codeberg](https://codeberg.org/Gurov/gurov). Open an issue before proposing a new package. New contributors must prepare contributions without AI assistance; see [AGENTS.md](AGENTS.md) for the full policy.
Keep changes focused. Verify versions, source URLs, licences, and dependencies against upstream. When equivalent Linux binaries are available as `.deb` and `.rpm`, prefer the `.deb` after checking their contents. Put patches in the package's `files/` directory and explain why they're needed.
## Exheres style
- Follow nearby recipes. Keep the copyright header and group metadata, dependencies, and phases in the same order. Omit fields supplied by an exlib and phases the package does not need.
- Indent with four spaces. Group dependencies by purpose (`build`, `build+run`, `run`, then `test` or `suggestion` if needed). Leave out empty groups and unused options.
- Preserve package-specific pins, archive names, slots, and restrictions. Formatting changes must not change how a package builds.
Before opening a pull request:
1. Check metadata and preview dependency resolution for the package you changed:
```sh
cave show category/package::gurov
cave resolve category/package::gurov
```
2. Build and test what changed when possible. Report failed or skipped checks.
3. Review the diff and run `git diff --check`.
Replace `category/package` with the package you changed. Do not add `-x` to the preview command.
|
