What this is all about.
Switch branches/tags
Clone or download
Latest commit fc5d565 Dec 6, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_data/tools Add links to a few more puppet-lint checks May 29, 2018
_includes add license to footer Dec 4, 2018
_layouts Add footer with get in touch links Jan 13, 2017
_posts announce open voting period Dec 6, 2018
coc coc: Upgrade to 1.4.0 of the Contributor Covenant Feb 7, 2016
docs Update github team for migrations Nov 1, 2018
elections Added Leadership page Nov 18, 2018
plugins Update all Github links to reflect new org name Jan 2, 2016
posts New version of the site! Jan 1, 2016
privacy-policy Grammatical fixes May 31, 2018
security Change from Best to Good practices ; link to gpg signing. Dec 5, 2016
static Add link to PR manager Nov 19, 2018
.gitignore update .gitignore Apr 18, 2016
.rubocop.yml rubocop autofix Sep 28, 2017
.travis.yml bump ruby to 2.4.1 Jun 12, 2017
404.md Add a 404 page Jan 5, 2016
CNAME Update CNAME to voxpupuli.org! Jan 2, 2016
Gemfile rubocop autofix Sep 28, 2017
LICENSE License the material under the Apache2 License Jun 12, 2017
README.md Fix validation issues with html-proofer (#46) Jun 11, 2016
Rakefile Remove html-proofer test because it has random failures Jun 12, 2017
_config-dev.yml Add config and docs for building the site locally Jan 15, 2016
_config.yml Merge pull request #149 from binford2k/elections-info Nov 19, 2018
about.md New version of the site! Jan 1, 2016
favicon.ico Add a favicon Jun 11, 2016
feed.xml New version of the site! Jan 1, 2016
freenode.txt Add freenode authentication token Jun 3, 2017
index.html Add link to PR manager Nov 19, 2018

README.md

voxpupuli.github.io Build Status

The https://voxpupuli.org site. Have a look at it to see what this is all about.

Building this site

  • bundle install
  • bundle exec jekyll serve -w --config _config.yml,_config-dev.yml

You can also use the rake tasks defined in the Rakefile:

  • build: jekyll build
  • validate: uses html-proofer to check the generated site
  • clean: removes the ./_site directory Jekyll generated

Puppet Plugins

Tools and plugins that appear on the Plugins page of our site are defined in the _data/tools directory. Tools without plugins are going to be listed in the table under the Tools header. Tools with plugins will have their own header and table listing the plugins defined for that tool.

Tool definition format

There's a single hash in each tool's definition that describes the tool and optionally contains an array of plugins that can be used with that tool. A tool that doesn't have any plugins will be listed in the table under the Tools header while a tool that does have plugins will have its own header and a table listing all plugins in the tool's plugins array.

Tool Schema:

Key Value Data Type Required or Optional
name String Required
display_name String Required
url String Required
description String Required
plugins Array Optional

Plugin Schema:

Key Value Data Type Required or Optional
name String Required
url String Required
description String Required

What's a tool vs. a plugin?

The difference can be kind of fluid, so I figured it would be helpful to define plugin and tool.

A plugin cannot generally be used independent of another tool. Plugins add functionality to another tool. An example of a plugin is beaker-libvirt because it enables libvirt as a hypervisor in Beaker.

A tool can generally be used independent of another specific tool or it is a tool that has plugins itself. An example of a tool is rspec-puppet because it has plugins. Another example of a tool is modulesync because it can be used independent of another tool.