(doc) Add and test for current REFERENCE.md using puppet-strings

Adds a REFERENCE.md generated with puppet-strings, and minimal changes
needs to validate in the main pr_testing workflow that a given pr's
REFERENCE.md is up to date with the state of the module.

Author: jpartlow

.github/workflows/pr_testing.yaml

@@ -26,6 +26,19 @@ jobs:
       - name: Run ShellCheck
         run: shellcheck -x tasks/*.sh files/*.sh
 
+  reference-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.3'
+          bundler-cache: true
+      - name: Regenerate REFERENCE.md
+        run: bundle exec puppet strings generate --format markdown
+      - name: Check whether REFERENCE.md has uncommitted changes
+        run: git diff --exit-code REFERENCE.md
+
   test-install-task-on-ubuntu:
     strategy:
       matrix:

.gitignore

@@ -3,4 +3,5 @@
 .rerun.json
 .resource_types
 .task_cache.json
+.yardoc
 Puppetfile

Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+
+group :development do
+  # For REFERENCE.md generation.
+  gem 'puppet', '~> 8.0'
+  gem 'puppet-strings'
+end

REFERENCE.md

@@ -0,0 +1,71 @@
+# Reference
+
+<!-- DO NOT EDIT: This document was generated by Puppet Strings -->
+
+## Table of Contents
+
+### Tasks
+
+* [`install`](#install): Installs the openvox-agent package.
+* [`install_build_artifact`](#install_build_artifact): Downloads and installs a package directly from openvox build artifact server. This can be used to help with testing builds prior to release. 
+
+## Tasks
+
+### <a name="install"></a>`install`
+
+Installs the openvox-agent package.
+
+**Supports noop?** false
+
+#### Parameters
+
+##### `version`
+
+Data type: `Optional[String]`
+
+The version of the openvox-agent package to install. Defaults to latest.
+
+##### `collection`
+
+Data type: `Optional[String]`
+
+The openvox collection to install from.
+
+##### `apt_source`
+
+Data type: `Optional[String]`
+
+The apt source repository to retrieve deb packages from.
+
+##### `yum_source`
+
+Data type: `Optional[String]`
+
+The yum source repository to retrieve rpm packages from.
+
+### <a name="install_build_artifact"></a>`install_build_artifact`
+
+Downloads and installs a package directly from openvox build artifact server. This can be used to help with testing builds prior to release. (To install a released version, use the openvox_bootstrap::install task.)
+
+**Supports noop?** false
+
+#### Parameters
+
+##### `version`
+
+Data type: `String[1]`
+
+The version of the package to install.
+
+##### `package`
+
+Data type: `String[1]`
+
+The name of the package to install.
+
+##### `artifacts_source`
+
+Data type: `String[1]`
+
+URL to the build artifacts server.
+