-# Class: stdlib::stages
-#
-# This class manages a standard set of run stages for Puppet. It is managed by
-# the stdlib class, and should not be declared independently.
+# @summary
+# This class manages a standard set of run stages for Puppet. It is managed by
+# the stdlib class, and should not be declared independently.
#
+# Declares various run-stages for deploying infrastructure,
+# language runtimes, and application layers.
+#
# The high level stages are (in order):
-#
# * setup
# * main
# * runtime
# * deploy_app
# * deploy
#
-# Parameters: none
-#
-# Actions:
-#
-# Declares various run-stages for deploying infrastructure,
-# language runtimes, and application layers.
-#
-# Requires: nothing
-#
-# Sample Usage:
-#
-# node default {
-# include ::stdlib
-# class { java: stage => 'runtime' }
-# }
+# @example
+# node default {
+# include ::stdlib
+# class { java: stage => 'runtime' }
+# }
#
class stdlib::stages {