Updated docs

Author: Daniel Opitz

docs/deletes.md

@@ -0,0 +1,84 @@
+## Deletes
+
+Create a delete object:
+
+```php
+use Odan\Database\Connection;
+
+$db = new Connection($dsn, $username, $password, $options);
+$delete = $db->delete();
+```
+
+The query builder may also be used to delete records from the 
+table via the delete method. You may constrain delete 
+statements by adding where clauses before calling the delete method:
+
+
+```php
+$db->delete()->from('users')->execute(); // DELETE FROM `users`
+$db->delete()->from('users')->where('votes', '>', 100)->execute(); // DELETE FROM `users` WHERE `votes` > '100'
+```
+
+If you wish to truncate the entire table, which will remove 
+all rows and reset the auto-incrementing ID to zero, 
+you may use the truncate method:
+
+```php
+$db->delete()->from('users')->truncate()->execute(); // TRUNCATE TABLE `users`; 
+```
+
+### Order of Deletion
+
+If the DELETE statement includes an ORDER BY clause, rows are deleted in the 
+order specified by the clause. This is useful primarily in conjunction with LIMIT. 
+
+```php
+$db->delete()->from('some_logs')
+    ->where('username', '=', 'jcole')
+    ->orderBy('created_at') 
+    ->limit(1)
+    ->execute();
+```
+
+ORDER BY also helps to delete rows in an order required to avoid referential integrity violations.
+
+### Delete Limit
+
+The LIMIT clause places a limit on the number of rows that can be deleted. 
+
+```php
+$db->delete()->from('users')->limit(10)->execute();
+```
+
+### Delete Low Priority
+
+If you specify `LOW_PRIORITY`, the server delays execution of the 
+DELETE until no other clients are reading from the table. 
+
+This affects only storage engines that use only table-level 
+locking (such as MyISAM, MEMORY, and MERGE).
+
+```php
+$db->delete()->from('users')->lowPriority()->execute();
+```
+
+### Delete and ignore errors
+
+The `IGNORE` modifier causes MySQL to ignore errors during the process of deleting rows. 
+
+(Errors encountered during the parsing stage are processed in the usual manner.) 
+
+Errors that are ignored due to the use of IGNORE are returned as warnings.
+
+```php
+$db->delete()->from('users')->ignore()->execute();
+```
+
+### Delete Quick modifier
+
+For MyISAM tables, if you use the QUICK modifier, the storage engine 
+does not merge index leaves during delete, which may speed up some kinds of delete operations.
+
+```php
+$db->delete()->from('users')->quick()->execute();
+```

docs/inserts.md

@@ -0,0 +1,71 @@
+## Inserts
+
+Create a insert object:
+
+```php
+use Odan\Database\Connection;
+
+$db = new Connection($dsn, $username, $password, $options);
+$insert = $db->insert();
+```
+
+### Insert A Single Row
+
+The query builder also provides an insert method for inserting 
+records into the database table. 
+
+The insert method accepts an array of column names and values:
+
+```php
+$db->insert()
+    ->into('test')
+    ->set(['email' => '[email protected]', 'votes' => 0])
+    ->execute();
+```
+
+You may even insert several records into the table with a single call 
+to insert by passing an array of arrays. Each array represents a 
+row to be inserted into the table:
+
+```php
+$db->insert()
+    ->into('test')->set([
+        ['email' => '[email protected]', 'votes' => 0],
+        ['email' => '[email protected]', 'votes' => 0]
+    ])->execute();
+```
+
+### Auto-Incrementing IDs
+
+If the table has an auto-incrementing id, 
+use the insertGetId method to insert a record and then retrieve the ID:
+
+```php
+$userId = $db->insert()->into('users')->insertGetId(['email' => '[email protected]', 'votes' => 0]);
+```
+
+Another way to get the last inserted ID:
+
+```php
+$db->insert()
+    ->into('users')
+    ->set(['email' => '[email protected]', 'votes' => 0])
+    ->execute();
+    
+$userId = $db->lastInsertId();
+```
+
+### Number of rows affected by the last statement
+
+Sometimes you need more then just the last inserted ID, for example the number of affected rows.
+You can find this information in the Statement object:
+
+```php
+$stmt = $db->insert()
+    ->into('users')
+    ->set(['email' => '[email protected]', 'votes' => 0])
+    ->prepare();
+    
+$stmt->execute();
+$rowCount = $stmt->rowCount(); // 1
+```