Clean up the PKGBUILD page a bit

Keep the commonly looked up info at the top and put it
in a table, so it's easier to scan.

Author: lazka

web/dev/pkgbuild.md

@@ -2,40 +2,39 @@
 
 PKGBUILD is the Arch Linux package build description file, which we inherit by
 using pacman. See https://man.archlinux.org/man/PKGBUILD.5 for details on the
-format.
-
-We have some minor extensions to the format, which are documented here.
+format. We have some minor extensions to the format, which are documented here.
 
 ## Extra Metadata
 
-Variables starting with `msys2_` and `mingw_` can be used to add additional metadata to a package, which will be read and used by our tools. The following datatypes are supported:
+Variables starting with `msys2_` and `mingw_` can be used to add additional metadata to a package, which will be read and used by our tools.
+The following variables are recognized:
 
-* Strings: `msys2_myvar="example"` 🠆 `{"myvar": "example"}`
-* Arrays of strings: `msys2_myvar=("example1" "example2")` 🠆 `{"myvar": ["example1", "example2"]}`
-* Mappings of strings to an optional string, separated by `":"`, values are
-  stripped: `msys2_myvar=("example1: value1" "example2")` 🠆 `{"myvar": {"example1": "value1", "example2": null}}`
-* Booleans (either `true` or `false`): `msys2_myvar=true` 🠆 `{"myvar": true}`
+| Variable                   | Type    | Description |
+|--------------------------- |---------|-------------|
+| `mingw_arch`               | array   | A list of MSYS2 environments the package is built for. Defaults to an empty list. |
+| `msys2_internal`           | boolean | Whether the package is an internal or meta package and shouldn't be linked to external sources. Defaults to `false`. |
+| `msys2_references`         | mapping | Maps the package to external resources, such as other package repositories. |
+| `msys2_documentation_url`  | string  | URL to the documentation for the API, tools, etc., in case it's a different website than the homepage. |
+| `msys2_repository_url`     | string  | URL to the web view of the repository, e.g., on GitHub or GitLab. |
+| `msys2_issue_tracker_url`  | string  | URL to the bug tracker, mailing list archive, etc. |
+| `msys2_pgp_keys_url`       | string  | URL to a website containing which keys are used to sign releases. |
 
-The following variables are recognized:
+For `msys2_references` the following keys are recognized:
 
-* `mingw_arch` - array - a list of MSYS2 environments the package is built
-  for. Defaults to an empty list.
-* `msys2_internal` - boolean - whether the package is an internal or meta
-  package, and shouldn't be linked to external sources. Defaults to `false`.
-* `msys2_references` - mapping - maps the package to external resources, for
-  example other package repositories. Defining a key without a value means there
-  is no mapping. The following keys exist:
-    * `archlinux` - the Arch Linux package name: https://archlinux.org/packages/
-    * `aur` - the AUR package name: https://aur.archlinux.org/packages
-    * `cygwin` - the cygwin package name: https://cygwin.com/packages/src_package_list.html
-    * `cygwin-mingw64` -
-      the cygwin package name for all packages starting with "mingw64-x86_64-",
-      minus that prefix: https://cygwin.com/packages/src_package_list.html
-    * `pypi` - the PyPI project name: https://pypi.org/search/
-* `msys2_changelog_url` - string -  NEWS file in git or the github releases page. In
-  case there are multiple, the one that is more useful for packagers
-* `msys2_documentation_url` - string - Documentation for the API, tools, etc. provided,
-  in case it's a different website than the homepage.
-* `msys2_repository_url` - string - Web view of the repository, e.g. on github or gitlab
-* `msys2_issue_tracker_url` - string - The bug tracker, mailing list, etc.
-* `msys2_pgp_keys_url` - string - A website containing which keys are used to sign releases
+* `archlinux` - the Arch Linux package name: https://archlinux.org/packages/
+* `aur` - the AUR package name: https://aur.archlinux.org/packages
+* `cygwin` - the cygwin package name: https://cygwin.com/packages/src_package_list.html
+* `cygwin-mingw64` -
+  the cygwin package name for all packages starting with "mingw64-x86_64-",
+  minus that prefix: https://cygwin.com/packages/src_package_list.html
+* `pypi` - the PyPI project name: https://pypi.org/search/
+
+Defining a key without a value means there is no mapping and the package shouldn't be linked.
+
+The following datatypes are supported:
+
+* **string:** `msys2_myvar="example"` 🠆 `{"myvar": "example"}`
+* **array:** Arrays of strings: `msys2_myvar=("example1" "example2")` 🠆 `{"myvar": ["example1", "example2"]}`
+* **mapping:** Mappings of strings to an optional string, separated by `":"`, values are
+  stripped: `msys2_myvar=("example1: value1" "example2")` 🠆 `{"myvar": {"example1": "value1", "example2": null}}`
+* **boolean:** either `true` or `false`: `msys2_myvar=true` 🠆 `{"myvar": true}`