From 56f5a0a0068c6a7ba69d5b91bf05f664b6dfc1a4 Mon Sep 17 00:00:00 2001
From: Bryant Mairs <bryant@mai.rs>
Date: Sat, 15 Apr 2017 12:12:33 -0700
Subject: [PATCH] List supported targets in the README

---
 README.md | 33 +++++++++++++++++++++++++++++++--
 1 file changed, 31 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index ab6f80fdba..88e963942b 100644
--- a/README.md
+++ b/README.md
@@ -30,8 +30,37 @@ pub unsafe extern fn gethostname(name: *mut c_char, len: size_t) -> c_int;
 pub fn gethostname(name: &mut [u8]) -> Result<()>;
 ```
 
-## Requirements
-Rust >= 1.13.0
+## Supported Platforms
+
+nix target support consists of three tiers:
+
+  * Tier 1 - Target is supported and CI both builds and tests
+  * Tier 2 - Target is supported and CI builds the target
+  * Tier 3 - Target is supported and CI both builds and tests but test failures
+             do not block merging code
+
+The following targets are all supported by nix on Rust 1.13.0 or newer:
+
+Tier 1:
+  * i686-unknown-linux-gnu
+  * x86_64-unknown-linux-gnu
+  * i686-apple-darwin
+  * x86_64-apple-darwin
+  * aarch64-unknown-linux-gnu
+  * armv7-unknown-linux-gnueabihf
+  * arm-unknown-linux-gnueabi
+
+Tier 2:
+  * i686-unknown-freebsd
+  * x86_64-unknown-freebsd
+  * x86_64-unknown-netbsd
+
+Tier 3:
+  * i686-unknown-linux-musl
+  * x86_64-unknown-linux-musl
+  * mips-unknown-linux-gnu
+  * mipsel-unknown-linux-gnu
+  * powerpc-unknown-linux-gnu
 
 ## Usage