diff --git a/platform/darwin/README.md b/platform/darwin/README.md
new file mode 100644
index 000000000..cbeaf844a
--- /dev/null
+++ b/platform/darwin/README.md
@@ -0,0 +1,7 @@
+# Darwin
+
+The code in the Darwin platform targets Apple platforms but is not specific
+to iOS or OS X. This code is not distributed as an SDK in itself, but is required
+by the [iOS](https://github.com/mapbox/mapbox-gl-native/tree/master/platform/ios)
+and [OS X](https://github.com/mapbox/mapbox-gl-native/tree/master/platform/osx)
+platforms.