wip refactor

1 files changed, 67 insertions, 97 deletions

diff --git a/contribs.yml b/contribs.yml
index 20ec3aa..6620ea7 100644
--- a/contribs.yml
+++ b/contribs.yml
@@ -1,100 +1,70 @@
-tags:
-  docs:
-    prettyName: Documentation
-    desc: |
-      I'm working to improve documentation for GNU/Linux, but more
-      than that I'm working to improve the forms of documentation that
-      more skilled technical writers might be afraid or incapable of
-      working on: `--help` text, generated documentation, and auditing
-      documentation against the source code to make sure that it is
-      accurate and complete.
-  ARM:
-    prettyName: ARM support
-    desc: |
-      Not that folks can't use GNU/Linux on ARM (obviously, the
-      Raspberry Pi has been a huge success), but there's still a lot
-      more friction to using GNU/Linux on ARM compared to x86.  I'm
-      working on that.
-  GI:
-    prettyName: GObject Introspection
-    desc: |
-      GObject Introspection (which is a terrible name for what it is,
-      btw) is a cross-(language-runtime) object system.  GObject was
-      an object system for C that game out of GTK+, and then GObject
-      Introspection was created as a way to specify the ABI for
-      working with an object, so that GObjects could be used from
-      other languages.  I think that GObject Introspection is a really
-      cool technology that can be the basis of reducing friction
-      between languages, but it needs better/more-ubiquitous tooling.
+- urls: [https://github.com/flori/json/pull/567]
+  tags: [Ruby, JSON, SoftwareFreedom]
+  desc: |
+    ruby-json contains code that is not Free under the FSF's
+    definition, not Open Source under the OSI's definition, and not
+    GPL-compatible.  This has coused much consternation among folks
+    who care about any of those 3 things.
 
-contributions:
-  - urls: [https://github.com/flori/json/pull/567]
-    tags: [Ruby, JSON, SoftwareFreedom]
-    desc: |
-      ruby-json contains code that is not Free under the FSF's
-      definition, not Open Source under the OSI's definition, and not
-      GPL-compatible.  This has coused much consternation among folks
-      who care about any of those 3 things.
+    This PR replaces that non-Free code with Free code, removing
+    friction for Ruby users on GNU/Linux distros that care about those
+    3 things.
+- urls: [https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio/-/merge_requests/328]
+  tags: [ARM]
+  sponsored-by: Umorpha Systems
+  desc: |
+    To do its work, mkinitcpio needs to know the version number of the
+    Linux kernel that it is generating an image for; the normal way
+    that it knows this is to sniff the version number from the kernel
+    file.  However, it fails to sniff the version number from ARM
+    zImage kernels, which means that Arch Linux ARM and Parabola for
+    ARM need to resort to hacks to get mkinitcpio to work right.
 
-      This PR replaces that non-Free code with Free code, removing
-      friction for Ruby users on GNU/Linux distros that care about
-      those 3 things.
-  - urls: [https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio/-/merge_requests/328]
-    tags: [ARM]
-    sponsored-by: Umorpha Systems
-    desc: |
-      To do its work, mkinitcpio needs to know the version number of
-      the Linux kernel that it is generating an image for; the normal
-      way that it knows this is to sniff the version number from the
-      kernel file.  However, it fails to sniff the version number from
-      ARM zImage kernels, which means that Arch Linux ARM and Parabola
-      for ARM need to resort to hacks to get mkinitcpio to work right.
+    This PR removes that friction by teaching mkinitcpio to understand
+    ARM zImage files.
+- urls: [https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio/-/merge_requests/277]
+  sponsored-by: Umorpha Systems
+  desc: |
+    One of the things going on in the secure-boot world is moving
+    toward "Unified Kernel Images" (UKI), which are when the kernel
+    and the init-ramdisk are bundled together into a single file to
+    reduce the risk of a compromised init-ramdisk being able to
+    compromise a secured kernel.  This PR reduces friction when using
+    mkinitcpio to generate images directly as UKI without generating a
+    plain init-ramdisk first.
+- urls:
+    - https://mailman.astron.com/pipermail/file/2024-April/001335.html
+    - https://github.com/file/file/commit/cf139abf35d07ebfd0c3edcab2fc400a211c0fbb
+  tags: [ARM]
+  desc: |
+    This PR improves its ability to detect information about Linux
+    kernel ARM zImage files.
+- urls:
+    - https://mailman.astron.com/pipermail/file/2024-March/001327.html
+    - https://github.com/file/file/commit/3b92878ee277a6b6c0a37429e9edf5e5b55fcdd4
+  tags: [docs]
+  desc: |
+    To do this, `file` reads a "magic" file that describes the magic
+    numbers that it might see in a file.  This PR fixes a mistake in
+    the `magic(5)` manual for writing such files.
+- urls: [https://github.com/diamondburned/gotk4/pull/140]
+  tags: [GI, docs]
+  desc: |
+    The not-quite-markdown format that `.gir` files use for
+    documentation is under-specified and hard to parse.  Right now I'm
+    focusing on how to properly parse it, so that we can have
+    top-notch language-specific documentation for GI libraries.
 
-      This PR removes that friction by teaching mkinitcpio to
-      understand ARM zImage files.
-  - urls: [https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio/-/merge_requests/277]
-    sponsored-by: Umorpha Systems
-    desc: |
-      One of the things going on in the secure-boot world is moving
-      toward "Unified Kernel Images" (UKI), which are when the kernel
-      and the init-ramdisk are bundled together into a single file to
-      reduce the risk of a compromised init-ramdisk being able to
-      compromise a secured kernel.  This PR reduces friction when
-      using mkinitcpio to generate images directly as UKI without
-      generating a plain init-ramdisk first.
-  - urls:
-      - https://mailman.astron.com/pipermail/file/2024-April/001335.html
-      - https://github.com/file/file/commit/cf139abf35d07ebfd0c3edcab2fc400a211c0fbb
-    tags: [ARM]
-    desc: |
-      This PR improves its ability to detect information about Linux
-      kernel ARM zImage files.
-  - urls:
-      - https://mailman.astron.com/pipermail/file/2024-March/001327.html
-      - https://github.com/file/file/commit/3b92878ee277a6b6c0a37429e9edf5e5b55fcdd4
-    tags: [docs]
-    desc: |
-      To do this, `file` reads a "magic" file that describes the magic
-      numbers that it might see in a file.  This PR fixes a mistake in
-      the `magic(5)` manual for writing such files.
-  - urls: [https://github.com/diamondburned/gotk4/pull/140]
-    tags: [GI, docs]
-    desc: |
-      The not-quite-markdown format that `.gir` files use for
-      documentation is under-specified and hard to parse.  Right now
-      I'm focusing on how to properly parse it, so that we can have
-      top-notch language-specific documentation for GI libraries.
-
-      This PR is laying the groundwork for the new parser.
-  - urls:
-    - https://lists.ozlabs.org/pipermail/linux-erofs/2023-November/009765.html
-    - https://github.com/erofs/erofs-utils/commit/f528b82ffbcb15484a7195c1a1d08ece0ff67350
-    - https://github.com/erofs/erofs-utils/commit/197e3294bcdf93f37d12989cd830a33c055b1a53
-    - https://github.com/erofs/erofs-utils/commit/f97311883337eb7e0ded55e60995e6599eba73e5
-    tags: [docs]
-    sponsored-by: Umorpha Systems
-    desc: |
-      This patchset improves the `--help` documentation and
-      man-pages the EroFS userspace tools, and reduces friction by
-      having `fsck.erofs` accept common command line flags that fsck
-      implementions for other filesystems take.
+    This PR is laying the groundwork for the new parser.
+- urls:
+  - https://lists.ozlabs.org/pipermail/linux-erofs/2023-November/009765.html
+  - https://github.com/erofs/erofs-utils/commit/f528b82ffbcb15484a7195c1a1d08ece0ff67350
+  - https://github.com/erofs/erofs-utils/commit/197e3294bcdf93f37d12989cd830a33c055b1a53
+  - https://github.com/erofs/erofs-utils/commit/f97311883337eb7e0ded55e60995e6599eba73e5
+  tags: [docs]
+  sponsored-by: Umorpha Systems
+  desc: |
+    This patchset improves the `--help` documentation and man-pages
+    the EroFS userspace tools, and reduces friction by having
+    `fsck.erofs` accept common command line flags that fsck
+    implementions for other filesystems take.