Add general "Code standards" page

docs/standards/index.md

@@ -0,0 +1,22 @@
+# Code standards
+
+In general, CiviCRM follow's the [Drupal Coding Standards](https://www.drupal.org/docs/develop/standards), but we have some minor modifications which are noted specifically in the other pages in this chapter.
+
+## Continuous integration
+
+Jenkins will automatically check all pull requests for code standards conformance, and code which does not meet the standards will not be merged. 
+
+
+## Tools
+
+If you have a development site with [buildkit]() you can use [Civilint](/tools/civilint.md) to check your code against CiviCRM's code standards.
+
+You can also [set up your IDE](https://wiki.civicrm.org/confluence/display/CRMDOC/IDE+Settings+to+Meet+Coding+Standards) to lint your code.
+
+
+## Improving code conformance
+
+If you find code that is not meeting the standards, we encourage you to improve it! But please follow these guidelines when doing so: 
+
+* Create a Jira issue for your code standard improvements which is separate from any other code changes you happen to be making at the time. 
+* Isolate your code standards improvements into commits which do not contain otherwise unrelated changes.

docs/standards/php.md

@@ -60,9 +60,3 @@ The CiviCRM Coding Standard for PHP Code and Inline Documentation applies to all
 1. `tools/`
 1. `joomla/`
 1. `WordPress/`
-
-## Tools
-
-If a developer creates a test site with buildkit they can use the CiviLint tool to check the code standards. See [Civilint Documentation](/tools/civilint.md).
-
-You can also Set up your IDE to lint your code as well. See instructions on [setting up your IDE](https://wiki.civicrm.org/confluence/display/CRMDOC/IDE+Settings+to+Meet+Coding+Standards).

mkdocs.yml

@@ -203,8 +203,9 @@ pages:
     - hook_civicrm_tokenValues: hooks/hook_civicrm_tokenValues.md
     - hook_civicrm_unhandledException: hooks/hook_civicrm_unhandledException.md
 - Code Standards:
-  - PHP: standards/php.md
-  - SQL: standards/sql.md
+  - Code Standards: standards/index.md
+  - PHP Standards: standards/php.md
+  - SQL Standards: standards/sql.md
   # Javascript: standards/js.md
   # API: standards/api.md
   # Git: standards/git.md