From 01ad0ffa00023f9b28563c21e37cf2112cfcf713 Mon Sep 17 00:00:00 2001
From: Adam Reese <adam@reese.io>
Date: Mon, 29 Feb 2016 09:55:51 -0800
Subject: [PATCH] doc(rootfs): add rootfs README

---
 rootfs/README.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 rootfs/README.md

diff --git a/rootfs/README.md b/rootfs/README.md
new file mode 100644
index 000000000..161bc9e9f
--- /dev/null
+++ b/rootfs/README.md
@@ -0,0 +1,26 @@
+# RootFS
+
+This directory stores all files that should be copied to the rootfs of a
+Docker container. The files should be stored according to the correct
+directory structure of the destination container. For example:
+
+```
+rootfs/bin -> /bin
+rootfs/usr/local/share -> /usr/local/share
+```
+
+## Dockerfile
+
+A Dockerfile in the rootfs is used to build the image. Where possible,
+compilation should not be done in this Dockerfile, since we are
+interested in deploying the smallest possible images.
+
+Example:
+
+```Dockerfile
+FROM alpine:3.2
+
+COPY . /
+
+ENTRYPOINT ["/usr/local/bin/boot"]
+```