diff --git a/README.md b/README.md
index 162dda2..bbda352 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,19 @@
 # dockerfiles
+
 various dockerfiles
+
+## building
+
+core docker images reside at docker hub under the `uconncore` organization.
+
+[https://hub.docker.com/u/uconncore/](https://hub.docker.com/u/uconncore/)
+
+therefore, when building, tags must have the `uconncore` namespace.
+
+### example
+
+```
+$ cd mysql-data
+$ docker build -t uconncore/mysql-data .
+$ docker push uconncore/mysql-data
+```