diff --git a/docs/packaging/index.md b/docs/packaging/index.md index f1a88cb6d..3f862ec8e 100644 --- a/docs/packaging/index.md +++ b/docs/packaging/index.md @@ -20,6 +20,8 @@ Please check the following: - Search [open package requests](https://github.com/getsolus/packages/issues?q=sort%3Aupdated-desc+is%3Aopen+label%3A%22Package%3A+Addition+Request%22) to see if there is one for the package. If there isn't an existing issue, go ahead and submit your pull request. If there is already a pull request, please check its status to avoid duplicating work. - If you are submitting a pull request for the inclusion of software in the repo, the package has a corresponding package request that is **accepted for inclusion** or is a dependency of a package that has been accepted into the repository. +- If you are updating a package, check to see if there's a maintainer. See [Updating an Existing Package].(docs/packaging/updating-an-existing-package.md). +- If this is your first package update with your environment, see [Your First Package Update](docs/packaging/your-first-package-update.md) to test your build environment. ## Building packages diff --git a/docs/packaging/packaging-practices.md b/docs/packaging/packaging-practices.md index 70be8864e..4e2bc8754 100644 --- a/docs/packaging/packaging-practices.md +++ b/docs/packaging/packaging-practices.md @@ -50,6 +50,10 @@ If this happens, simply override with `patterns` or set `libsplit` to “no”. **A note on static archives**: Unless it is absolutely unavoidable, you should disable static libraries within your build. This is usually fixed by adding `--disable-static` to your configure routine. If `*.a` files are shown in your packaging request, it will be questioned, as they can pose a greater security risk if packages link against these static archives. +#### Development modules should be normal packages without a -devel subpackage + +In the cases where modules like `perl` or `python` would be split by the default `ypkg` policy (for instance because they contain category 3 `man` pages), the current best practice is to add a `patterns : /*` stanza to keep everything in the main package for convenience. + ### The docs subpackage Currently there is only one pattern which is forced into a `docs` subpackage: diff --git a/docs/packaging/procedures/_category_.json b/docs/packaging/procedures/_category_.json index 487cfed02..a083cba9a 100644 --- a/docs/packaging/procedures/_category_.json +++ b/docs/packaging/procedures/_category_.json @@ -1,5 +1,5 @@ { - "label": "Procedures", + "label": "Procedures & Policies", "link": { "type": "generated-index" }