README → README.md

@@ -20,10 +20,10 @@ regularily!
 
 Description of the YAML format used in the two files:
 
-packages.yml
-------------
+`packages.yml`
+--------------
 
-`packages.yml` is a YAML file with notes about source packages.
+`packages.yml` is a YAML file with notes about debian source packages.
 
 A full entry looks like the following:
 
@@ -49,8 +49,8 @@ cleanups.
 
 If an issue for the package has been fixed in sid, it should be removed from `packages.yml`.
 
-issues.yml
-----------
+`issues.yml`
+------------
 
 `issues.yml` is a YAML file with a description of common issues.
 
@@ -74,3 +74,14 @@ text editor autocompletion works better with the former.
  - `deterministic` (default False): is an optional field indicating whether
     we expect that this issue would always happen on Jenkins; i.e. if
     there is a successful build, then the issue is fixed for that package.
+
+Arch Linux
+----------
+
+Classifications for Arch Linux packages are currently tracked here:
+
+https://gitlab.archlinux.org/archlinux/reproducible-archlinux-notes
+
+Machine-readable data is available here:
+
+https://reproducible-notes.archlinux.org/packages.json