added mkdocs based documentation

.gitignore

@@ -4,3 +4,4 @@ releases
 .bats
 chocolatey/kubeval/kubeval.*.nupkg
 dist
+site

Pipfile

@@ -0,0 +1,13 @@
+[[source]]
+name = "pypi"
+url = "https://pypi.org/simple"
+verify_ssl = true
+
+[dev-packages]
+
+[packages]
+mkdocs = "*"
+mkdocs-material = "*"
+
+[requires]
+python_version = "3.7"

docs/about.md

@@ -0,0 +1,17 @@
+# Welcome to MkDocs
+
+For full documentation visit [mkdocs.org](https://mkdocs.org).
+
+## Commands
+
+* `mkdocs new [dir-name]` - Create a new project.
+* `mkdocs serve` - Start the live-reloading docs server.
+* `mkdocs build` - Build the documentation site.
+* `mkdocs help` - Print this help message.
+
+## Project layout
+
+    mkdocs.yml    # The configuration file.
+    docs/
+        index.md  # The documentation homepage.
+        ...       # Other markdown pages, images and other files.

docs/index.md

@@ -0,0 +1,17 @@
+# Welcome to MkDocs
+
+For full documentation visit [mkdocs.org](https://mkdocs.org).
+
+## Commands
+
+* `mkdocs new [dir-name]` - Create a new project.
+* `mkdocs serve` - Start the live-reloading docs server.
+* `mkdocs build` - Build the documentation site.
+* `mkdocs help` - Print this help message.
+
+## Project layout
+
+    mkdocs.yml    # The configuration file.
+    docs/
+        index.md  # The documentation homepage.
+        ...       # Other markdown pages, images and other files.

mkdocs.yml

@@ -0,0 +1,5 @@
+site_name: Kubeval
+theme:
+  name: "material"
+repo_url: https://github.com/instrumenta/kubeval
+

requirements.txt

@@ -0,0 +1,13 @@
+-i https://pypi.org/simple
+click==7.0
+jinja2==2.10.1
+livereload==2.6.0
+markdown==3.1
+markupsafe==1.1.1
+mkdocs-material==4.1.2
+mkdocs==1.0.4
+pygments==2.3.1
+pymdown-extensions==6.0
+pyyaml==5.1
+six==1.12.0
+tornado==6.0.2