CONTRIBUTING.md

   1 # Overlay QA/coding standards, etc.
   2
   3 This is a collection of notes and reminders for myself:
   4
   5 Use `pkgdev commit`; this autocorrects the `Manifest` files and fills in the
   6 commit message usefully. If it's a version bump with an upstream news item of
   7 note, then add `-T Upstream-Ref:$URL`
   8
   9 Don't bother using `pkgdev push` over `git push`, the pre-commit hook already
  10 runs its tests (and more besides).
  11
  12 Changelog URLs in `metadata.xml` always point to an upstream RSS/Atom list of
  13 releases. This is a wilful violation of Gentoo's spec, which has no way to
  14 specify machine-readable update URLs, because I find it uselessly stiff. Running
  15 `scripts/dump-feeds.raku` will spit out an OPML list of these.