(gh-19) Update REFERENCE.md

..with configure task and new type docs.

Author: jpartlow

REFERENCE.md

@@ -4,12 +4,61 @@
 
 ## Table of Contents
 
+### Data types
+
+* [`OpenvoxBootstrap::CerShortNames`](#OpenvoxBootstrap--CerShortNames): Certificate extension request short names. These are the allowed short names documented for Puppet(TM) extension requests per [csr_attributes
+* [`OpenvoxBootstrap::CsrAttributes`](#OpenvoxBootstrap--CsrAttributes): [csr_attributes.yaml](https://help.puppet.com/core/current/Content/PuppetCore/config_file_csr_attributes.htm)
+* [`OpenvoxBootstrap::IniFile`](#OpenvoxBootstrap--IniFile): Simple type for data to be transformed to an INI file format.
+* [`OpenvoxBootstrap::Oid`](#OpenvoxBootstrap--Oid): Object Identifier per https://en.wikipedia.org/wiki/Object_identifier
+
 ### Tasks
 
 * [`check`](#check): Check whether a Puppet(tm) implementation is installed. Optionally checks the version.
+* [`configure`](#configure): Provides initial configuration for a freshly installed openvox-agent.
 * [`install`](#install): Installs an openvox package. By default, this will be the latest openvox-agent from the latest collection.
 * [`install_build_artifact`](#install_build_artifact): Downloads and installs a package directly from the openvox build artifact server.
 
+## Data types
+
+### <a name="OpenvoxBootstrap--CerShortNames"></a>`OpenvoxBootstrap::CerShortNames`
+
+Certificate extension request short names.
+These are the allowed short names documented for Puppet(TM)
+extension requests per [csr_attributes.yaml](https://help.puppet.com/core/current/Content/PuppetCore/config_file_csr_attributes.htm)
+
+Alias of `Enum['pp_uuid', 'pp_instance_id', 'pp_image_name', 'pp_preshared_key', 'pp_cost_center', 'pp_product', 'pp_project', 'pp_application', 'pp_service', 'pp_employee', 'pp_created_by', 'pp_environment', 'pp_role', 'pp_software_version', 'pp_department', 'pp_cluster', 'pp_provisioner', 'pp_region', 'pp_datacenter', 'pp_zone', 'pp_network', 'pp_securitypolicy', 'pp_cloudplatform', 'pp_apptier', 'pp_hostname', 'pp_authorization', 'pp_auth_role']`
+
+### <a name="OpenvoxBootstrap--CsrAttributes"></a>`OpenvoxBootstrap::CsrAttributes`
+
+[csr_attributes.yaml](https://help.puppet.com/core/current/Content/PuppetCore/config_file_csr_attributes.htm)
+
+Alias of
+
+```puppet
+Struct[{
+    Optional['custom_attributes']  => Hash[
+      OpenvoxBootstrap::Oid,
+      String
+    ],
+    Optional['extension_requests'] => Hash[
+      Variant[OpenvoxBootstrap::Oid,OpenvoxBootstrap::CerShortNames],
+      String
+    ],
+  }]
+```
+
+### <a name="OpenvoxBootstrap--IniFile"></a>`OpenvoxBootstrap::IniFile`
+
+Simple type for data to be transformed to an INI file format.
+
+Alias of `Hash[String, Hash[String, String]]`
+
+### <a name="OpenvoxBootstrap--Oid"></a>`OpenvoxBootstrap::Oid`
+
+Object Identifier per https://en.wikipedia.org/wiki/Object_identifier
+
+Alias of `Pattern[/\d+(\.\d+)*/]`
+
 ## Tasks
 
 ### <a name="check"></a>`check`
@@ -32,6 +81,38 @@ Data type: `Enum['eq', 'lt', 'le', 'gt', 'ge']`
 
 Version comparison operator.
 
+### <a name="configure"></a>`configure`
+
+Provides initial configuration for a freshly installed openvox-agent.
+
+**Supports noop?** false
+
+#### Parameters
+
+##### `puppet_conf`
+
+Data type: `Optional[OpenvoxBootstrap::IniFile]`
+
+Hash of puppet configuration settings to write to the puppet.conf ini file. NOTE: This will completely overwrite any existing settings in the file; there is no merging behavior in this task.
+
+##### `csr_attributes`
+
+Data type: `Optional[OpenvoxBootstrap::CsrAttributes]`
+
+Hash of CSR attributes (custom_attributes and extension_requests) to write to the csr_attributes.yaml file. NOTE: This will completely overwrite any existing settings in the file; there is no merging behavior in this task.
+
+##### `puppet_service_running`
+
+Data type: `Boolean`
+
+Whether the Puppet service should be running after this task completes. Defaults to true.
+
+##### `puppet_service_enabled`
+
+Data type: `Boolean`
+
+Whether the Puppet service should be enabled to start on boot after this task completes. Defaults to true.
+
 ### <a name="install"></a>`install`
 
 Installs an openvox package. By default, this will be the latest openvox-agent from the latest collection.