move the documentation to markdown

Docker-DCO-1.1-Signed-off-by: Sven Dowideit <SvenDowideit@home.org.au> (github: SvenDowideit)

docs/Dockerfile

@@ -1,19 +1,45 @@
-FROM ubuntu:12.04
-MAINTAINER Nick Stinemates
 #
-#    docker build -t docker:docs . && docker run -p 8000:8000 docker:docs
+# See the top level Makefile in https://github.com/dotcloud/docker for usage.
 #
+FROM 		debian:jessie
+MAINTAINER	Sven Dowideit <SvenDowideit@docker.com> (@SvenDowideit)
 
-# TODO switch to http://packages.ubuntu.com/trusty/python-sphinxcontrib-httpdomain once trusty is released
+RUN 	apt-get update && apt-get install -yq make python-pip python-setuptools vim-tiny git pandoc
 
-RUN apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -yq make python-pip python-setuptools
+RUN	pip install mkdocs
+
+# installing sphinx for the rst->md conversion only - will be removed after May release
 # pip installs from docs/requirements.txt, but here to increase cacheability
-RUN pip install Sphinx==1.2.1
-RUN pip install sphinxcontrib-httpdomain==1.2.0
-ADD . /docs
-RUN make -C /docs clean docs
+RUN	pip install Sphinx==1.2.1
+RUN	pip install sphinxcontrib-httpdomain==1.2.0
+
+# add MarkdownTools to get transclusion
+# (future development)
+#RUN	easy_install -U setuptools
+#RUN	pip install MarkdownTools2
+
+# this week I seem to need the latest dev release of awscli too
+# awscli 1.3.6 does --error-document correctly
+# https://github.com/aws/aws-cli/commit/edc2290e173dfaedc70b48cfa3624d58c533c6c3
+RUN	pip install awscli
+
+# get my sitemap.xml branch of mkdocs and use that for now
+RUN	git clone https://github.com/SvenDowideit/mkdocs	&&\
+	cd mkdocs/						&&\
+	git checkout docker-markdown-merge			&&\
+	./setup.py install
+
+ADD 	. /docs
+ADD	MAINTAINERS /docs/sources/humans.txt
+WORKDIR	/docs
+
+#build the sphinx html
+#RUN	make -C /docs clean docs
+
+#convert to markdown
+RUN	./convert.sh
 
-WORKDIR /docs/_build/html
-CMD ["python", "-m", "SimpleHTTPServer"]
 # note, EXPOSE is only last because of https://github.com/dotcloud/docker/issues/3525
-EXPOSE 8000
+EXPOSE	8000
+
+CMD 	["mkdocs", "serve"]