Skip to content

Commit

Permalink
document all parameters with puppet-strings
Browse files Browse the repository at this point in the history
  • Loading branch information
bastelfreak committed Oct 1, 2024
1 parent 2a2883a commit 898c7f9
Show file tree
Hide file tree
Showing 4 changed files with 76 additions and 1 deletion.
1 change: 0 additions & 1 deletion .puppet-lint.rc
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,3 @@
# https://voxpupuli.org/docs/updating-files-managed-with-modulesync/

--fail-on-warnings
--no-parameter_documentation-check
1 change: 1 addition & 0 deletions .sync.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,3 +2,4 @@
.puppet-lint.rc:
enabled_lint_checks:
- parameter_types
- parameter_documentation
66 changes: 66 additions & 0 deletions REFERENCE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# Reference

<!-- DO NOT EDIT: This document was generated by Puppet Strings -->

## Table of Contents

### Classes

* [`catalog_diff::viewer`](#catalog_diff--viewer): installs the catalog-diff viewer

## Classes

### <a name="catalog_diff--viewer"></a>`catalog_diff::viewer`

installs the catalog-diff viewer

#### Parameters

The following parameters are available in the `catalog_diff::viewer` class:

* [`remote`](#-catalog_diff--viewer--remote)
* [`password`](#-catalog_diff--viewer--password)
* [`revision`](#-catalog_diff--viewer--revision)
* [`port`](#-catalog_diff--viewer--port)
* [`listen_ip`](#-catalog_diff--viewer--listen_ip)

##### <a name="-catalog_diff--viewer--remote"></a>`remote`

Data type: `String`

the url to the git repo of the catalog diff viewer

Default value: `'https://github.com/voxpupuli/puppet-catalog-diff-viewer.git'`

##### <a name="-catalog_diff--viewer--password"></a>`password`

Data type: `String`

password for basic authentication

Default value: `'puppet'`

##### <a name="-catalog_diff--viewer--revision"></a>`revision`

Data type: `String`

the desired branch/rev that you want to checkout

Default value: `'master'`

##### <a name="-catalog_diff--viewer--port"></a>`port`

Data type: `Integer`

where apache will listen on

Default value: `1495`

##### <a name="-catalog_diff--viewer--listen_ip"></a>`listen_ip`

Data type: `String`

the desired ip adddress to listen on

Default value: `$facts['networking']['ip']`

9 changes: 9 additions & 0 deletions manifests/viewer.pp
Original file line number Diff line number Diff line change
@@ -1,3 +1,12 @@
#
# @summary installs the catalog-diff viewer
#
# @param remote the url to the git repo of the catalog diff viewer
# @param password password for basic authentication
# @param revision the desired branch/rev that you want to checkout
# @param port where apache will listen on
# @param listen_ip the desired ip adddress to listen on
#
class catalog_diff::viewer (
String $remote = 'https://github.com/voxpupuli/puppet-catalog-diff-viewer.git',
String $password = 'puppet',
Expand Down

0 comments on commit 898c7f9

Please sign in to comment.