Incoporate @mikeyMJCO's review suggestions

Co-Authored-By: Mikey O'Toole <mikey@mjco.uk>

docs/api/v4/actions.md

@@ -2,31 +2,32 @@
 
 Most entities support the following actions:
 
-## create
+## Create
 
-Insert one records into the database.
+Insert new records into the database.
 
 ## Update
 
-Update a record in the database.
+Update records in the database.
 
-## delete
+## Delete
 
-Delete one or more records. (Note: Requires an explicit `id`. Note: if you want to skip the 'recycle bin' for entities that support undelete (e.g. contacts) you should set `$param['skip_undelete'] => 1);`
+Delete one or more records. Requires an explicit `id`. If you want to skip the 'recycle bin' for entities that support undelete (e.g. contacts) you should set `$param['skip_undelete'] => 1);`
 
-## get
+## Get
 
 Search for records
 
-## getfields
+## GetFields
 
 Fetch entity metadata, i.e. the list of fields supported by the entity. There is now an option that you can pass in for get fields which is `loadOptions`. This is the equivilant of the apiv3 getoptions API call. When used for any field that specifies a pseudoconstant it will return the relevant options in an options key. You can also pass in an option `IncludeCustom` which will specifiy whether to include the relevant custom fields for that entity or not.
 
-## replace
+## Replace
 
 Replace an old set of records with a new or modified set of records. (For example, replace the set of "Phone" numbers with a different set of "Phone" numbers.).
 
-Warning - REPLACE includes an implicit delete - use with care & test well before using in productions
+!!! warning
+    Replace includes an implicit delete action - use with care & test well before using in production.
 
 ## Save
 

docs/api/v4/usage.md

@@ -11,8 +11,8 @@ Canonically, an API call is processed by the API kernel.  The `$entity`, `$actio
 
 A couple of significant differences between APIv4 and APIv3 is that in v4 the `check_permissions` flag is set to true by default and on get actions especially but more generally the limit of 25 items returned that v3 has has been removed in favour of coders specifying the limit if they want to in their code calls.
 
-!!! note
-   As of October 2019 Not all core entities have been added to apiv4. You should check the API explorer to see what entities are avaliable. If there is not one then please open a pull request to `civicrm-core` repository to add the entity in.
+!!! info
+   As of CiviCRM version 5,18 not all core entities have been added to APIv4. You should check the API explorer to see which entities are available. If the entity you require is not available then please open a pull request against the [`civicrm-core` repository](https://github.com/civicrm/civicrm-core) to add the entity in or open an (issue)[https://lab.civicrm.org/dev/core] and request that the entity is added.
 
 ```php
 $result = Civi::service('civi_api_kernel')->run('Contact', 'get', [