examples of the cron plus config parameters

Author: jwmach1

README.md

@@ -1,11 +1,41 @@
-parameterized-scheduler
+Parameterized Scheduler
 =======================
 
-A Jenkins Plugin to support setting parameters in the build schedule
+A Jenkins Plugin to support setting parameters in the build schedule. Using multiple cron lines each ending with a % and some name=value pairs you can schedule your parameterized build to run with different parameters at different times. It may turn out that 
+[this improvement request JENKINS-16352](https://issues.jenkins-ci.org/browse/JENKINS-16352)
+will be implemented in Jenkins core. Then this plugin will no longer be needed. My first thought is to try it out as a plugin.
 
 After you save your project with some parameters (yes, save, then go back into the config page) you will see 
 >Build periodically with parameters
 
 in the *Build Triggers* section as shown here:
 
 ![Parameterized Schedular Config](https://raw2.github.com/jwmach1/parameterized-scheduler/master/site/images/configurationexample.png)
+
+## Configuration Example ##
+The cron line before the _%_ symbol is processed the same as the jenkins core _Build periodically Schedule_. Leave a space. Put in a _%_. Then add the name=value pairs you need for your project build parameters.
+
+The idea was born from the need to use a different environment. To use a different TestNG configuration xml. In this example the _env_ parameter will be set to int during the build triggered at 15 after each hour. Then _env_ will be qa when the build runs at half past. 
+
+```
+  #lets run against the integration environment at 15 past the hour
+  15 * * * * % env=int
+  #run QA too
+  30 * * * % env=qa
+```
+
+
+Yes, of course you can set multiple parameters. Lets say you have three parameters:
+- furniture
+- color
+- name (with a default of fred)
+
+Then you might want a schedule like the following:
+
+```
+  # leave spaces where you want them around the parameters. They'll be trimmed.
+  # we let the build run with the default name
+  5 * * * *%furniture=chair;color=black
+  # now, let's override that default name and use Mr. Rubble.
+  10 * * * * % furniture=desk; color=yellow; name=barney
+```