Merge pull request #285 from seanmadsen/wiki-db-standards

Migrate "Database standards" wiki page

docs/standards/database.md

+# Database standards
+
+The following standards apply to the database layer in CiviCRM:
+
+1. Every BAO will have a create function. This will be called by the API & form layer.
+1. The create function will take a single params array.
+1. Depending on the parameters passed in, the create function will perform any additional actions like creating activities.
+1. The create function will call hooks.
+1. We are moving away from the `$ids` array being included.
+1. The add function (if it exists) will be internal to the BAO layer.
+1. If any additional actions are to be done when deleting the BAO there should be a function `del` which takes the entity id as the only required parameter.
+1. The delete action will take any additional tasks like deleting additional objects (generally done by code).
+1. The delete action will take an array including `['id']`.
+1. The api will call the `del` action & fall back onto delete. It is recommended that the form layer call the API.

mkdocs.yml

@@ -232,6 +232,7 @@ pages:
   - Coding Standards: standards/index.md
   - PHP Standards: standards/php.md
   - Javascript Reference: standards/javascript.md
+  - Database Standards: standards/database.md
   # API: standards/api.md
   # Git: standards/git.md
 - Documentation:

redirects/wiki-crmdoc.txt

@@ -165,3 +165,4 @@ Icons framework/ui
 In-Place+Field+Editing framework/ui
 Notifications+and+Confirmations framework/ui
 Section+elements framework/ui
+Database+layer standards/database