diff --git a/docs/packaging/packaging-practices.md b/docs/packaging/packaging-practices.md index 4e6864f4e..157ca36b6 100644 --- a/docs/packaging/packaging-practices.md +++ b/docs/packaging/packaging-practices.md @@ -93,21 +93,22 @@ All new packages or updates to packages should abide by the [SPDX 3.x](https://s ## Build dependencies :::note -Build dependencies should be listed in the following order in `package.yml` -pkgconfig dependencies in alphabetical order -explicitly named dependencies in alphabetical order +Build dependencies should be ordered according to the following rules in `package.yml`: +1. `pkgconfig` dependencies before explicitly named dependencies +2. Each of these two groups in so-called ASCIIbetical order (that is, alphabetical order with all uppercase letters before lowercase letters, and digits/punctuation before letters, [see here](https://en.wikipedia.org/wiki/ASCII#Character_order)) Example: ```yaml builddeps : + - pkgconfig(MYGUI) + - pkgconfig(Qt5Core) - pkgconfig(ayatana-appindicator-0.1) - pkgconfig(dri) - pkgconfig(gtk+-3.0) - - pkgconfig(libnotify) - - pkgconfig(libpcsclite) - - pkgconfig(pango) - - pkgconfig(python3) + - The-Powder-Toy + - abcMIDI + - abcm2ps - git - python-poetry - swig