diff --git a/README.md b/README.md
index d3670b9..aa093ab 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 A curated list of awesome Rust code and resources. Inspired by the other [awesome lists](https://github.com/bayandin/awesome-awesomeness).
 
-Only projects that are stable and useful to users are added. Projects that do not compile with Rust-nightly for a longer time are moved to `UNSTABLE.md`.
+Only projects that are stable and useful to users are added. Projects that do not compile with Rust-nightly for a longer time are moved to [UNSTABLE.md](UNSTABLE.md).
 
 - [Awesome Rust](#awesome-rust)
   - [Code](#code)
@@ -90,11 +90,11 @@ Only projects that are stable and useful to users are added. Projects that do no
 * XML
   * [Florob/RustyXML](https://github.com/Florob/RustyXML) — an XML parser written in Rust [<img src="https://travis-ci.org/Florob/RustyXML.svg?branch=master">](https://travis-ci.org/Florob/RustyXM)
   * [netvl/rust-xml](https://github.com/netvl/rust-xml) — a streaming XML library [<img src="https://travis-ci.org/netvl/rust-xml.svg?branch=master">](https://travis-ci.org/netvl/rust-xml)
-  * [Ygg01/xml-air](https://github.com/Ygg01/xml-air) — A hybrid pull, DOM parser written in pure Rust [<img src="https://travis-ci.org/Ygg01/xml-air.svg?branch=master">](https://travis-ci.org/Ygg01/xml-air)
 
 ### Game development
 
 * [PistonDevelopers/piston](https://github.com/pistondevelopers/piston) — [<img src="https://travis-ci.org/PistonDevelopers/piston.svg?branch=master">](https://travis-ci.org/PistonDevelopers/piston)
+* [SiegeLord/RustAllegro](https://github.com/SiegeLord/RustAllegro) — [Allegro 5](http://liballeg.org/) bindings [<img src="https://travis-ci.org/SiegeLord/RustAllegro.svg?branch=master">](https://travis-ci.org/SiegeLord/RustAllegro)
 
 ### Games
 
diff --git a/UNSTABLE.md b/UNSTABLE.md
index e4b8a9a..cbdd3f4 100644
--- a/UNSTABLE.md
+++ b/UNSTABLE.md
@@ -65,6 +65,7 @@ A list of awesome but unstable/experimental Rust projects which some day hopeful
 * Tnetstring
   * [erickt/rust-tnetstring](https://github.com/erickt/rust-tnetstring) — [<img src="https://travis-ci.org/erickt/rust-tnetstring.svg?branch=master">](https://travis-ci.org/erickt/rust-tnetstring)
 * XML
+  * [Ygg01/xml-air](https://github.com/Ygg01/xml-air) — A hybrid pull, DOM parser written in pure Rust [<img src="https://travis-ci.org/Ygg01/xml-air.svg?branch=master">](https://travis-ci.org/Ygg01/xml-air)
 
 ### Game development
 
@@ -73,7 +74,6 @@ A list of awesome but unstable/experimental Rust projects which some day hopeful
 * [sebcrozet/kiss3d](https://github.com/sebcrozet/kiss3d)
 * [sebcrozet/ncollide](https://github.com/sebcrozet/ncollide)
 * [sebcrozet/nphysics](https://github.com/sebcrozet/nphysics)
-* [SiegeLord/RustAllegro](https://github.com/SiegeLord/RustAllegro) — [Allegro 5](http://liballeg.org/) bindings [<img src="https://travis-ci.org/SiegeLord/RustAllegro.svg?branch=master">](https://travis-ci.org/SiegeLord/RustAllegro)
 
 ### Games
 
diff --git a/generate_markdown_files.py b/generate_markdown_files.py
index 4dbd629..ffa6a41 100644
--- a/generate_markdown_files.py
+++ b/generate_markdown_files.py
@@ -1,4 +1,9 @@
 # -*- coding: utf-8 -*-
+"""
+Generates the files `README.md` and `UNSTABLE.md`.
+It helps keep the content in a sane format and also allows for entries
+to be easily switched between stable/unstable status.
+"""
 
 def md_link(name, url):
   "Returns a web link in Markdown format"
@@ -154,7 +159,8 @@ DATA = \
           "url": "https://github.com/Ygg01/xml-air",
           "descr": "A hybrid pull, DOM parser written in pure Rust",
           "travis_url": "https://travis-ci.org/Ygg01/xml-air",
-          "travis_badge": "https://travis-ci.org/Ygg01/xml-air.svg?branch=master"
+          "travis_badge": "https://travis-ci.org/Ygg01/xml-air.svg?branch=master",
+          "unstable": True
         },
       "Florob/RustyXML": {
           "url": "https://github.com/Florob/RustyXML",
@@ -390,7 +396,6 @@ DATA = \
           "descr": md_link('Allegro 5', 'http://liballeg.org/') + " bindings",
           "travis_url": "https://travis-ci.org/SiegeLord/RustAllegro",
           "travis_badge": "https://travis-ci.org/SiegeLord/RustAllegro.svg?branch=master",
-          "unstable": True
         },
       "bjz/bullet-rs": {
           "url": "https://github.com/bjz/bullet-rs",
@@ -417,7 +422,7 @@ HEADER_STABLE = \
 
 A curated list of awesome Rust code and resources. Inspired by the other [awesome lists](https://github.com/bayandin/awesome-awesomeness).
 
-Only projects that are stable and useful to users are added. Projects that do not compile with Rust-nightly for a longer time are moved to `UNSTABLE.md`."""
+Only projects that are stable and useful to users are added. Projects that do not compile with Rust-nightly for a longer time are moved to [UNSTABLE.md](UNSTABLE.md)."""
 
 HEADER_UNSTABLE = \
 """# Unstable