(FM-7819) Detail known Bolt keywords

Detail the keywords currently known from Bolt

Author: Will Meek

README.md

@@ -268,7 +268,31 @@ Puppet::ResourceAPI.register_transport(
 )
 ```
 
-After this, `puppet device` will be able to use the new provider, and supply it (through the device class) with the URL specified in the [`device.conf`](https://puppet.com/docs/puppet/5.3/config_file_device.html).
+##### Transport Schema keywords
+
+Please note that within the transport schema, the following keywords are reserved words:
+
+###### Usable within the schema
+
+The following keywords are encouraged within the Transport schema:
+
+* `host` - Use to specify and IP or address to connect to
+* `uri` - Use when you need to specify a specific URL to connect to. Cannot be used alongside host.
+* `protocol` - this can be - depending on Bolt execution method: 
+  * `remote`
+  * `local`
+
+
+###### Non-Usable within the schema
+
+The following keywords are keywords that must not be used by the transport schema:
+
+* `credentials`
+* `name`
+* `run-on`
+* `remote-*` - Any keywords beginning `remote-`
+
+After the device class, transport class and transport schema have been implemented, `puppet device` will be able to use the new provider, and supply it (through the device class) with the URL specified in the [`device.conf`](https://puppet.com/docs/puppet/5.3/config_file_device.html).
 
 #### Transport/device specific providers