diff --git a/README b/README
deleted file mode 100644
index 62d8dc7..0000000
--- a/README
+++ /dev/null
@@ -1,28 +0,0 @@
-In build upstream bare repo (webserver:/usr/local/src/web/example.com/www/), run:
-	# chown root:srv .
-	# chmod g+ws .
-	# git init --bare --shared=group
-	# git config receive.denyCurrentBranch updateInstead
-	# git config receive.denyNonFastForwards false
-	?(# git config core.sharedRepository true)    # if needed because of missing init option
-
-Set upstream and push branches to new bare repo, then run:
-	# git worktree add /srv/prod/example.com/www master
-	# git worktree add /srv/beta/example.com/www release
-	# git worktree add /srv/dev/example.com/www dev
-
-	# chmod -R g+w .
-	# chmod g+w /srv/*/example.com/www
-
-
-	# chown -R root:srv .
-	# chmod -R g+swX .
-	# chown root:srv /srv/prod/example.com/www
-	# chmod g+swX /srv/prod/example.com/www
-	# chown root:srv /srv/beta/example.com/www
-	# chmod g+swX /srv/beta/example.com/www
-	# chown root:srv /srv/dev/example.com/www
-	# chmod g+swX /srv/dev/example.com/www
-and add your user (on the server) to the srv group.
-
-
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..780523e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,132 @@
+Example Web Server/Site Template
+================================
+
+
+-------------------------------------------------
+Project Layout
+-------------------------------------------------
+
+### Project Working Copy
+
+```
+~/Projects/Web/example.com/			# git repo (git ignore www)
+	|
+	|-- docker-compose.yml
+	|
+	|-- service/
+	|	|
+	|	|-- docker-compose.yml
+	|
+	|-- www/						# git repo (git ignore build)
+	|	|
+	|	|-- Makefile
+	|	|
+	|	|-- index.pug
+	|	|
+	|	|-- build/					# git repo (if not building target on server, e.g. static GitHub pages)
+	|	|	|
+	|	|	|-- index.html
+	|	|
+	|	|-- config/
+```
+
+### Hosted Project Collaboration
+
+```
+git@examplecodehost.com:organization/example.com.git			# server config repo
+git@examplecodehost.com:organization/www.example.com.git		# site source repo
+```
+
+### Server Deployment
+
+```
+/usr/local/src/web/example.com/
+	|
+	|-- server/						# bare git repo for server config
+	|
+	|-- www/						# bare git repo for site build files (or optionally site source files if server builds project)
+	|
+	|-- build/						# optional bare git repo for build files if server builds project automatically
+```
+
+Git branches are checked out to different worktrees to be served:
+```
+/srv/dev/example.com/				# dev branch server config
+	|
+	|-- docker-compose.yml
+	|
+	|-- www/						# dev branch built site
+
+/srv/beta/example.com/				# release branch server config
+	|
+	|-- docker-compose.yml
+	|
+	|-- www/						# release branch built site
+
+/srv/prod/example.com/				# master branch server config
+	|
+	|-- docker-compose.yml
+	|
+	|-- www/						# master branch built site
+
+```
+Dev, beta, and prod could all be on different servers if appropriate.
+
+
+-------------------------------------------------
+Server Groups and Directory Permissions
+-------------------------------------------------
+
+
+Add your user (on the server) to the srv group.  Set directory permissions
+```
+# chown root:srv .
+# chmod g+ws .
+# setfacl -d -m g::rwx .
+```
+for all relevant directories (newly created subdirectories should inherit permissions):
+```
+/usr/local/src/web/example.com/
+/usr/local/src/web/example.com/server/
+/usr/local/src/web/example.com/www/
+/usr/local/src/web/example.com/build/
+/srv/dev/example.com/
+/srv/dev/example.com/www/
+/srv/beta/example.com/
+/srv/beta/example.com/www/
+/srv/prod/example.com/
+/srv/prod/example.com/www/
+```
+
+In upstream bare repo directories (e.g. `webserver:/usr/local/src/web/example.com/www/`), run:
+```
+# git init --bare --shared=group
+# git config receive.denyCurrentBranch updateInstead
+# git config receive.denyNonFastForwards false
+# git config core.sharedRepository true			# if needed because of missing init option
+```
+
+In working copy repos, set upstream and push branches to new bare repos, then in
+the bare repos run:
+```
+# git worktree add /srv/prod/example.com/www master
+# git worktree add /srv/beta/example.com/www release
+# git worktree add /srv/dev/example.com/www dev
+```
+
+Maybe needed if above permissions weren't set correctly:
+```
+# chmod -R g+w .
+# chmod g+w /srv/*/example.com/www
+
+# chown -R root:srv .
+# chmod -R g+swX .
+# chown root:srv /srv/prod/example.com/www
+# chmod g+swX /srv/prod/example.com/www
+# chown root:srv /srv/beta/example.com/www
+# chmod g+swX /srv/beta/example.com/www
+# chown root:srv /srv/dev/example.com/www
+# chmod g+swX /srv/dev/example.com/www
+```
+
+