README and example updates

certificates/README

@@ -1 +1,3 @@
-This directory contains certificates created by the Rakefile.
+Creating SSL certificates is a common task done in web application
+infrastructures, so a rake task is provided to generate certificates.
+These certificates are stored here by the ssl_cert task.

config/client.rb.example

@@ -1,7 +1,7 @@
 #
 # Example Chef Client Config File
 #
-# We recommend using Opscode's chef cookbook for managing chef itself,
+# Use Opscode's chef cookbook for managing chef itself,
 # instead of using this file. It is provided as an example.
 
 log_level          :info

config/knife.rb.example

@@ -1,3 +1,5 @@
+# This file provided as an example. Run 'knife configure' to generate a
+# config file for your local user.
 log_level                :info
 log_location             STDOUT
 node_name                'chef_admin'

config/server.rb.example

@@ -1,7 +1,7 @@
 #
 # Chef Server Config File
 #
-# We recommend using Opscode's chef cookbook for managing chef itself,
+# Use Opscode's chef cookbook for managing chef itself,
 # instead of using this file. It is provided as an example.
 
 log_level          :info

roles/README

@@ -1,4 +1,17 @@
 Create roles here, in either .rb or .json files. To install roles on the
-server, use knife. We provide an example role here.
+server, use knife. For example, create roles/base_example.rb:
 
-knife role from file roles/base_example.rb
+    name "base_example"
+    description "Example base role applied to all nodes."
+    # List of recipes and roles to apply. Requires Chef 0.8, earlier versions use 'recipes()'.
+    #run_list()
+
+    # Attributes applied if the node doesn't have it set already.
+    #default_attributes()
+
+    # Attributes applied no matter what the node has set already.
+    #override_attributes()
+
+Then upload it to the Chef Server:
+
+    knife role from file roles/base_example.rb

site-cookbooks/README

@@ -1,2 +1,2 @@
-This directory contains cookbooks that modify upstream ones,
+This directory contains cookbooks that modify upstream ones in cookbooks/,
 or that are specific to your site.