Initial commit to ONF Docs site
Change-Id: Ic882d6c7cc2f17a8fe74acee5cb70352b04aada2
diff --git a/tools/ansible.rst b/tools/ansible.rst
new file mode 100644
index 0000000..4847684
--- /dev/null
+++ b/tools/ansible.rst
@@ -0,0 +1,3 @@
+Ansible
+=======
+
diff --git a/tools/docker.rst b/tools/docker.rst
new file mode 100644
index 0000000..4509fde
--- /dev/null
+++ b/tools/docker.rst
@@ -0,0 +1,21 @@
+Docker
+======
+
+
+
+Security
+--------
+
+By default, the docker daemon will modify the firewall settings on the host
+machine. This is undesirable if the machine isn't behind another, separate
+non-host firewall.
+
+In general Docker workloads should be run within :doc:`Kubernetes
+<k8s>`.
+
+Linting
+-------
+
+Hadolint
+
+
diff --git a/tools/go.rst b/tools/go.rst
new file mode 100644
index 0000000..f1e53b9
--- /dev/null
+++ b/tools/go.rst
@@ -0,0 +1,4 @@
+Go
+==
+
+
diff --git a/tools/k8s.rst b/tools/k8s.rst
new file mode 100644
index 0000000..a105056
--- /dev/null
+++ b/tools/k8s.rst
@@ -0,0 +1,2 @@
+Kubernetes
+==========
diff --git a/tools/make.rst b/tools/make.rst
new file mode 100644
index 0000000..ed8b71e
--- /dev/null
+++ b/tools/make.rst
@@ -0,0 +1,28 @@
+Make
+====
+
+Make is a unix tool that provides a dependency-based way to execute commands.
+
+The make command takes a parameter, known as the **target** which is usually
+the name of a file you would like to generate, or set of commands you would
+like to run.
+
+
+Best Practices
+--------------
+
+Include a ``help`` target in the Makefile. This can be automatically generated
+from comments in the Makefile. There are many forms for this - this one is
+recommended::
+
+ # makefile example...
+
+This will work on both GNU and BSD implementations (``sed`` specifically).
+
+Formatting
+----------
+
+Each line of a Makefile is a new shell invocation - if you need to maintain the
+state of a shell (ex: entering a virtualenv, setting variables, etc.) you
+should wrap lines with ``;\\`` to separate individual commands while retaining
+the same shell instance.
diff --git a/tools/python.rst b/tools/python.rst
new file mode 100644
index 0000000..2b02ee4
--- /dev/null
+++ b/tools/python.rst
@@ -0,0 +1,30 @@
+Python
+======
+
+
+Formatting
+----------
+
+Black
+
+
+Lint
+----
+
+Pylint
+
+
+Testing
+-------
+
+Unittest
+
+
+Tox
+
+
+
+Taking a codebase from Python 2 to Python 3
+-------------------------------------------
+
+
diff --git a/tools/shell.rst b/tools/shell.rst
new file mode 100644
index 0000000..cf047fe
--- /dev/null
+++ b/tools/shell.rst
@@ -0,0 +1,12 @@
+Shell
+-----
+
+Shell scripts are frequently used for automating
+
+
+Lint
+----
+
+Shellcheck
+
+