From 806e147f7fca8fa4823536ca42504d889eab020d Mon Sep 17 00:00:00 2001
From: Jenkins Server <jenkins@confdroid.com>
Date: Mon, 2 Feb 2026 21:23:46 +0100
Subject: [PATCH] Recommit for updates in build 4

---
 doc/file.README.html | 62 ++++++++++++++++++++++++++++++++++++++------
 doc/index.html       | 62 ++++++++++++++++++++++++++++++++++++++------
 2 files changed, 108 insertions(+), 16 deletions(-)

diff --git a/doc/file.README.html b/doc/file.README.html
index e3d14e2..7021433 100644
--- a/doc/file.README.html
+++ b/doc/file.README.html
@@ -60,7 +60,50 @@
       <div id="content"><div id='filecontents'>
 <h1 id="label-Readme">Readme</h1>
 
-<p><a href="https://jenkins.confdroid.com/job/confdroid_puppet/"><img src="https://jenkins.confdroid.com/buildStatus/icon?job=confdroid_puppet"></a>|</p>
+<p><a href="https://jenkins.confdroid.com/job/confdroid_puppet/"><img src="https://jenkins.confdroid.com/buildStatus/icon?job=confdroid_puppet"></a> <a href="https://sonarqube.confdroid.com/dashboard?id=confdroid_puppet"><img src="https://sonarqube.confdroid.com/api/project_badges/measure?project=confdroid_puppet&amp;metric=security_hotspots&amp;token=sqb_97a025b42213e7290a4f6e3d459957ee96c49db8"></a></p>
+<ul><li>
+<p><a href="#readme">Readme</a></p>
+</li><li>
+<p><a href="#synopsis">Synopsis</a></p>
+</li><li>
+<p><a href="#warning">WARNING</a></p>
+</li><li>
+<p><a href="#features">Features</a></p>
+<ul><li>
+<p><a href="#puppet-server-and-agent">Puppet server and agent</a></p>
+</li><li>
+<p><a href="#firewall">Firewall</a></p>
+</li><li>
+<p><a href="#directories-files-and-services">Directories, Files and Services,</a></p>
+</li><li>
+<p><a href="#optional">Optional</a></p>
+</li><li>
+<p><a href="#r10k-service">R10k service</a></p>
+</li><li>
+<p><a href="#r10k-web-hook">R10k Web hook</a></p>
+</li><li>
+<p><a href="#puppetdb">Puppetdb</a></p>
+</li></ul>
+</li><li>
+<p><a href="#support">Support</a></p>
+</li><li>
+<p><a href="#parameter-inheritance">Parameter Inheritance</a></p>
+</li><li>
+<p><a href="#module-deployment">Module Deployment</a></p>
+<ul><li>
+<p><a href="#native-puppet-deployment-via-sitepp-or-nodespp">native Puppet deployment: via site.pp or nodes.pp</a></p>
+</li><li>
+<p><a href="#through-foreman">through Foreman</a></p>
+</li></ul>
+</li><li>
+<p><a href="#tests">Tests</a></p>
+</li><li>
+<p><a href="#contact-us">Contact Us</a></p>
+</li><li>
+<p><a href="#documentation">Documentation</a></p>
+</li><li>
+<p><a href="#disclaimer">Disclaimer</a></p>
+</li></ul>
 
 <h2 id="label-Synopsis">Synopsis</h2>
 
@@ -68,7 +111,7 @@
 
 <p>Optionally: * R10k to connect to a control repo and manage puppet modules * webhook listener to trigger r10k when a puppet module has been updated. * PuppetDB for exporting and storing resources.</p>
 
-<p>The syntax is specifically for Puppet Core 8 and Rocky 9, although might work elsewhere as well. This module is also designed to work with Foreman as External Node Classifier (ENC), although it does not install Foreman.</p>
+<p>The syntax is specifically for Puppet Core 8 and Rocky 9, although might work elsewhere as well. This module is also designed to work with <a href="https://www.theforeman.org/manuals/3.13/quickstart_guide.html">Foreman</a> as External Node Classifier (ENC), although it does not install Foreman.</p>
 
 <h2 id="label-WARNING">WARNING</h2>
 
@@ -78,7 +121,7 @@
 
 <h3 id="label-Puppet+server+and+agent">Puppet server and agent</h3>
 <ul><li>
-<p>if the host FQDN matches your specified Puppet master via <code>$pt_pm_fqdn</code>, it installs and configures a puppetmaster ready for serving with Foreman as ENC ( Foreman not yet included).</p>
+<p>if the host FQDN matches your specified Puppet master via <code>$pt_pm_fqdn</code>, it installs and configures a puppetmaster ready for serving with Foreman as ENC (Foreman not yet included). It specifically rewrites the puppet.conf with values taken from parameters.</p>
 </li><li>
 <p>Any other system becomes a puppet agent.</p>
 </li></ul>
@@ -109,9 +152,7 @@
 
 <h4 id="label-Puppetdb">Puppetdb</h4>
 <ul><li>
-<p>to do</p>
-</li><li>
-<p>install node.rb from the foreman for puppetdb</p>
+<p>installs and configures Puppetdb on the node specified with <code>pt_puppetdb_fqdn</code>, which can be the puppetmaster or any other node (recommended for performance reasons)</p>
 </li></ul>
 
 <h2 id="label-Support">Support</h2>
@@ -160,11 +201,16 @@
 </li></ul>
 
 <h2 id="label-Contact+Us">Contact Us</h2>
-
-<p><a href="https://confdroid.com/contact/">contact Us</a></p>
+<ul><li>
+<p><a href="https://confdroid.com/contact/">contact form</a></p>
+</li><li>
+<p><a href="https://feedback.confdroid.com/">feedback portal</a></p>
+</li></ul>
 
 <h2 id="label-Documentation">Documentation</h2>
 
+<p>Additional documentation like FAQ can be found in the wiki</strong><a href="https://3for.me/x1mar"></a>.</p>
+
 <h2 id="label-Disclaimer">Disclaimer</h2>
 
 <p>ConfDroid as entity is entirely independent from Puppet. We provide custom configuration modules, written for specific purposes and specific environments. The modules are tested and supported only as documented, and require testing in designated environments (i.e. lab or development environments) for parameter tuning etc. before deploying into production environments.</p>
diff --git a/doc/index.html b/doc/index.html
index a69df77..61cee29 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -60,7 +60,50 @@
       <div id="content"><div id='filecontents'>
 <h1 id="label-Readme">Readme</h1>
 
-<p><a href="https://jenkins.confdroid.com/job/confdroid_puppet/"><img src="https://jenkins.confdroid.com/buildStatus/icon?job=confdroid_puppet"></a>|</p>
+<p><a href="https://jenkins.confdroid.com/job/confdroid_puppet/"><img src="https://jenkins.confdroid.com/buildStatus/icon?job=confdroid_puppet"></a> <a href="https://sonarqube.confdroid.com/dashboard?id=confdroid_puppet"><img src="https://sonarqube.confdroid.com/api/project_badges/measure?project=confdroid_puppet&amp;metric=security_hotspots&amp;token=sqb_97a025b42213e7290a4f6e3d459957ee96c49db8"></a></p>
+<ul><li>
+<p><a href="#readme">Readme</a></p>
+</li><li>
+<p><a href="#synopsis">Synopsis</a></p>
+</li><li>
+<p><a href="#warning">WARNING</a></p>
+</li><li>
+<p><a href="#features">Features</a></p>
+<ul><li>
+<p><a href="#puppet-server-and-agent">Puppet server and agent</a></p>
+</li><li>
+<p><a href="#firewall">Firewall</a></p>
+</li><li>
+<p><a href="#directories-files-and-services">Directories, Files and Services,</a></p>
+</li><li>
+<p><a href="#optional">Optional</a></p>
+</li><li>
+<p><a href="#r10k-service">R10k service</a></p>
+</li><li>
+<p><a href="#r10k-web-hook">R10k Web hook</a></p>
+</li><li>
+<p><a href="#puppetdb">Puppetdb</a></p>
+</li></ul>
+</li><li>
+<p><a href="#support">Support</a></p>
+</li><li>
+<p><a href="#parameter-inheritance">Parameter Inheritance</a></p>
+</li><li>
+<p><a href="#module-deployment">Module Deployment</a></p>
+<ul><li>
+<p><a href="#native-puppet-deployment-via-sitepp-or-nodespp">native Puppet deployment: via site.pp or nodes.pp</a></p>
+</li><li>
+<p><a href="#through-foreman">through Foreman</a></p>
+</li></ul>
+</li><li>
+<p><a href="#tests">Tests</a></p>
+</li><li>
+<p><a href="#contact-us">Contact Us</a></p>
+</li><li>
+<p><a href="#documentation">Documentation</a></p>
+</li><li>
+<p><a href="#disclaimer">Disclaimer</a></p>
+</li></ul>
 
 <h2 id="label-Synopsis">Synopsis</h2>
 
@@ -68,7 +111,7 @@
 
 <p>Optionally: * R10k to connect to a control repo and manage puppet modules * webhook listener to trigger r10k when a puppet module has been updated. * PuppetDB for exporting and storing resources.</p>
 
-<p>The syntax is specifically for Puppet Core 8 and Rocky 9, although might work elsewhere as well. This module is also designed to work with Foreman as External Node Classifier (ENC), although it does not install Foreman.</p>
+<p>The syntax is specifically for Puppet Core 8 and Rocky 9, although might work elsewhere as well. This module is also designed to work with <a href="https://www.theforeman.org/manuals/3.13/quickstart_guide.html">Foreman</a> as External Node Classifier (ENC), although it does not install Foreman.</p>
 
 <h2 id="label-WARNING">WARNING</h2>
 
@@ -78,7 +121,7 @@
 
 <h3 id="label-Puppet+server+and+agent">Puppet server and agent</h3>
 <ul><li>
-<p>if the host FQDN matches your specified Puppet master via <code>$pt_pm_fqdn</code>, it installs and configures a puppetmaster ready for serving with Foreman as ENC ( Foreman not yet included).</p>
+<p>if the host FQDN matches your specified Puppet master via <code>$pt_pm_fqdn</code>, it installs and configures a puppetmaster ready for serving with Foreman as ENC (Foreman not yet included). It specifically rewrites the puppet.conf with values taken from parameters.</p>
 </li><li>
 <p>Any other system becomes a puppet agent.</p>
 </li></ul>
@@ -109,9 +152,7 @@
 
 <h4 id="label-Puppetdb">Puppetdb</h4>
 <ul><li>
-<p>to do</p>
-</li><li>
-<p>install node.rb from the foreman for puppetdb</p>
+<p>installs and configures Puppetdb on the node specified with <code>pt_puppetdb_fqdn</code>, which can be the puppetmaster or any other node (recommended for performance reasons)</p>
 </li></ul>
 
 <h2 id="label-Support">Support</h2>
@@ -160,11 +201,16 @@
 </li></ul>
 
 <h2 id="label-Contact+Us">Contact Us</h2>
-
-<p><a href="https://confdroid.com/contact/">contact Us</a></p>
+<ul><li>
+<p><a href="https://confdroid.com/contact/">contact form</a></p>
+</li><li>
+<p><a href="https://feedback.confdroid.com/">feedback portal</a></p>
+</li></ul>
 
 <h2 id="label-Documentation">Documentation</h2>
 
+<p>Additional documentation like FAQ can be found in the wiki</strong><a href="https://3for.me/x1mar"></a>.</p>
+
 <h2 id="label-Disclaimer">Disclaimer</h2>
 
 <p>ConfDroid as entity is entirely independent from Puppet. We provide custom configuration modules, written for specific purposes and specific environments. The modules are tested and supported only as documented, and require testing in designated environments (i.e. lab or development environments) for parameter tuning etc. before deploying into production environments.</p>