Documentation Commit

These files describe the process and problems I have with this module.

Author: Gary Larizza

LAYOUT.markdown

@@ -0,0 +1,22 @@
+# init.pp
+
+Accepts parameters of version (present, latest, or specific version number) as well as booleans for master, agent, and dashboard.  If dashboard is true, it includes the Class['dashboard'].
+
+# agent.pp
+
+Configures puppet agent package, service, puppet.conf (concat), and ensures the cron setting is present.
+
+# master.pp
+
+Configures the puppet master package, service, puppet.conf (concat), init script, Passenger (if needed), and Storeconfigs (if needed).
+
+# NEED TODO #
+
+Strip out Passenger, Dashboard, and storeconfigs to their own separate classes.  Fix all OS-specific logic, validate params, ensure portability.
+What about certname? Agent AND master?
+What about agent vs. master ssldir/vardir?
+Better method than concat?
+
+## Questions ##
+* With Validation - would be easier to define variables like $v_alphanum in stdlib if we use them frequently?
+* Where should validation occur - especially if we're calling out to dependent classes?

README

@@ -1 +1,9 @@
-puppetlabs-puppet is a configuration manager module that ensures the configuration of puppet agent, master, and dashboard.
+## Puppetlabs-puppet Module
+
+This module is a configuration manager module that ensures the configuration of puppet agent, master, and dashboard.  
+
+## NOTE ##
+
+It's a stub, at the moment, as its multiple dependency modules have yet to be published.  Once they've been published, then we can update this module.
+
+## Quick Start

todo

@@ -0,0 +1,10 @@
+# install activerecord for storeconfigs
+# install ruby sqlite and mysql libs
+# install passenger
+
+All these should be packages, not gems eh?
+
+mysql-server should get installed earlier
+
+dbpass and dbuser etc should only be used for the adapters that need it
+