diff --git a/howto/code/index.rst b/howto/code/index.rst
new file mode 100644
index 0000000..0d23582
--- /dev/null
+++ b/howto/code/index.rst
@@ -0,0 +1,8 @@
+Development & Source Code
+=========================
+
+.. toctree::
+   :maxdepth: 2
+
+   linting
+   pull_request
diff --git a/howto/code/linting.rst b/howto/code/linting.rst
new file mode 100644
index 0000000..e3619b2
--- /dev/null
+++ b/howto/code/linting.rst
@@ -0,0 +1,229 @@
+Source code syntax checking
+===========================
+
+Getting Started
+---------------
+
+.. code:: bash
+
+    git clone ssh://gerrit.opencord.org:29418/voltha-helm-charts.git
+    cd voltha-helm-charts
+
+    make help | grep lint
+    lint-chart                    chart_version_check.sh
+    lint-helm                     Syntax check helm configs
+    lint-json                     Syntax check json sources
+    lint-license                  Verify sources contain a license block.
+    lint-python                   Syntax check using pylint and flake8
+    lint-robot                    Syntax check robot sources using rflint
+    lint-shell                    Syntax check bash,bourne,etc sources
+    lint-yaml                     Syntax check yaml source using yamllint
+    UNSTABLE=                     Build targets prone to failure (lint-helm)
+
+|
+
+
+All Sources
++++++++++++
+
+The generic lint target can be used to invoke all defined lint targets.
+
+.. code:: bash
+
+    make clean
+    make lint 2>&1 | tee log
+
+|
+
+Helm Charts
++++++++++++
+
+Command(s):
+- `helmlint.sh <https://gerrit.opencord.org/plugins/gitiles/helm-repo-tools/+/refs/heads/master/helmlint.sh>`_
+
+.. code:: bash
+
+    make clean
+    make lint-chart lint-helm 2>&1 | tee log
+
+Sources:
+
+- `makefiles/lint <https://gerrit.opencord.org/plugins/gitiles/voltha-helm-charts/+/refs/heads/master/makefiles/lint/>`__
+- `makefiles/lint/helm.mk <https://gerrit.opencord.org/plugins/gitiles/voltha-helm-charts/+/refs/heads/master/makefiles/lint/helm.mk>`_
+- [`master <https://gerrit.opencord.org/plugins/gitiles/helm-repo-tools/+/refs/heads/master>`__] `helm-repo-tools <https://gerrit.opencord.org/plugins/gitiles/helm-repo-tools>`_
+
+|
+
+
+Golang
+++++++
+
+Command:
+
+Sources:
+
+- `makefiles/lint <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/makefiles/lint/>`__
+
+|
+
+JSON
+++++
+
+Command:
+- `json.tool <https://docs.python.org/3/library/json.html>`_
+
+.. code:: bash
+
+    make clean
+    make lint-json 2>&1 | tee log
+
+Sources:
+
+- `makefiles/lint <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/makefiles/lint/>`__
+- `makefiles/lint/json.mk <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/makefiles/lint/json.mk>`_
+
+|
+
+
+License / Copyright notice
+++++++++++++++++++++++++++
+
+Command:
+
+.. code:: bash
+
+    make clean
+    make lint-license 2>&1 | tee log
+
+Sources:
+
+- `makefiles/lint <https://gerrit.opencord.org/plugins/gitiles/voltha-system-tests/+/refs/heads/master/makefiles/lint>`__
+- `makefiles/lint/license.mk <https://gerrit.opencord.org/plugins/gitiles/voltha-system-tests/+/refs/heads/master/makefiles/lint/license/include.mk>`_
+
+|
+
+
+python
+++++++
+
+Command:
+- `flake8 <https://flake8.pycqa.org/en/latest>`_
+- `pylint <https://www.pylint.org/>`_
+
+.. code:: bash
+
+    make clean
+    make lint-python 2>&1 | tee log
+
+Sources:
+
+- `makefiles/lint <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/makefiles/lint/>`__
+- `makefiles/lint/python.mk <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/makefiles/lint/python.mk>`_
+- `makefiles/patches/include.mk <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/makefiles/patches/>`_
+
+Notes:
+
+- pylint --py3k options is no longer supported by v3.10+
+- lint-python target dependency will create a `python virtual env <https://wiki.opennetworking.org/display/JOEY/PythonVenv>`_
+- python 3.10+ requires `virtual env patching <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/patches/>`_
+
+|
+
+
+Robot
++++++
+
+Command: rflint
+
+Sources:
+
+- `makefiles/lint <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/makefiles/lint/>`__
+- `makefiles/lint/robot.mk <https://gerrit.opencord.org/plugins/gitiles/voltha-system-tests/+/refs/heads/master/makefiles/lint/robot.mk>`_
+
+|
+
+
+reStructedTextFile (rst)
+++++++++++++++++++++++++
+
+Command: `doc8 <https://pypi.org/project/doc8/>`_
+
+Sources:
+
+- `makefiles/lint <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/makefiles/lint/>`__
+- `Makefiles::doc8 <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/Makefile#98>`_
+
+|
+
+
+Shell
++++++
+
+Command: `shellcheck <https://github.com/koalaman/shellcheck>`_
+
+Sources:
+
+- `makefiles/lint <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/makefiles/lint/>`__
+- `makefiles/lint/shell.mk <https://gerrit.opencord.org/plugins/gitiles/voltha-system-tests/+/refs/heads/master/makefiles/lint/shell.mk>`_
+
+|
+
+
+Yaml
+++++
+
+Command: yamllint
+
+.. code:: bash
+
+    make clean
+    make lint-yaml 2>&1 | tee log
+
+Sources:
+
+- `makefiles/lint <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/makefiles/lint/>`__
+- `makefiles/lint/yaml.mk <https://gerrit.opencord.org/plugins/gitiles/voltha-system-tests/+/refs/heads/master/makefiles/lint/yaml.mk>`_
+
+|
+
+Makefile help
+~~~~~~~~~~~~~
+
+Individual Makefiles support a help targe that will display a list of
+targets and functionality supported.
+
+.. code:: bash
+
+    make help
+    make help-verbose
+    make help VERBOSE=1
+
+
+Bugs
+~~~~
+
+- `jira::VOLTHA <https://jira.opencord.org/projects/VOL>`-
+- Include repository URL
+- Include gerrit/github changeset if available.
+- A logfile snippet of the error and surrounding context.
+
+
+Repositories
+++++++++++++
+
+- [`master <https://gerrit.opencord.org/plugins/gitiles/bbsim/+/refs/heads/master>`__] `bbsim <https://gerrit.opencord.org/plugins/gitiles/bbsim>`_
+- [`master <https://gerrit.opencord.org/plugins/gitiles/pod-configs/+/refs/heads/master>`__] `pod-configs <https://gerrit.opencord.org/plugins/gitiles/pod-configs>`_
+- [`master <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master>`__] `voltha-docs <https://gerrit.opencord.org/plugins/gitiles/voltha-docs>`_
+- [`master <https://gerrit.opencord.org/plugins/gitiles/voltha-helm-charts/+/refs/heads/master>`__] `voltha-helm-charts <https://gerrit.opencord.org/plugins/gitiles/voltha-helm-charts>`_
+- [`master <https://gerrit.opencord.org/plugins/gitiles/voltha-system-tests/+/refs/heads/master>`__] `voltha-system-tests <https://gerrit.opencord.org/plugins/gitiles/voltha-system-tests>`_
+
+
+Notes
+~~~~~
+
+- Make lint complaints are not necessarily fatal.
+- Volume problem reports require cleanup before linting can become a default.
+- Lint target support is globally available across repositories, given time
+  it will be.  Submit patches as needed or open a jira ticket to request
+  linting support in specific repositories.
+- Makefile refactoring: yes absolutely! Baby steps are needed in the interim...