@@ -7,6 +7,7 @@

 #   test: Run tests.

 #   run: Run All-in-one server

 #   clean: Clean up.

+#   api: Generate new api docs.

 OUT_DIR = _output

 OUT_PKG_DIR = Godeps/_workspace/pkg

@@ -61,3 +62,10 @@ clean:

 	rm -rf $(OUT_DIR) $(OUT_PKG_DIR)

 .PHONY: clean

+# Generate api docs from .raml to .html.

+#

+# Example:

+#   make api

+api:

+	hack/build-api-docs-image.sh

+.PHONY: api

new file mode 100644

@@ -0,0 +1,5 @@

+FROM google/nodejs

+RUN npm i -g raml2html

+ADD . /data

+CMD ["-i", "/data/oov3.raml", "-o", "/data/oov3.html"]

+ENTRYPOINT ["raml2html"]

@@ -6,8 +6,13 @@ Use htmlpreview for github with a URL like:

 [https://rawgit.com/openshift/origin/master/api/oov3.html] (https://rawgit.com/openshift/origin/master/api/oov3.html)

 ## Generating the API document

-Use [raml2html](https://www.npmjs.org/package/raml2html):

 ```

-$ raml2html -i oov3.raml -o oov3.html

+make api

 ```

+

+or:

+```

+hack/build-api-docs-image.sh

+```

+

 For additional documentation on raml go to [http://raml.org/](http://raml.org/)

new file mode 100755

@@ -0,0 +1,13 @@

+#!/bin/bash

+

+set -o errexit

+set -o nounset

+set -o pipefail

+

+hackdir=$(CDPATH="" cd $(dirname $0); pwd)

+

+cd $hackdir/../api && docker build -t kubernetes/raml2html .

+docker rm oov3docgen &>/dev/null || :

+docker run --name=oov3docgen kubernetes/raml2html

+docker cp oov3docgen:/data/oov3.html $hackdir/../api/

+docker rm oov3docgen &>/dev/null || :