Rename README to README.md and start to update for current documentation conventions

FossilOrigin-Name: fc70d1e0e83e3e5644a60c9b2c7db62b03292f3225e9466da6b17c95d672a2a9

Author: danshearer

doc/examples/README renamed to doc/examples/README.md

@@ -1,13 +1,15 @@
+# Example option files for batch-benchmark
+
 This directory contains 3 example "option" files for the batch-benchmark tool.
 
 They will need to be modified to match local configuration, in particular
 options.03.storage need to match the reality of the system it runs on.
 
 To build all necessary combinations of versions and build-time options:
 
-perl tool/batch-benchmark doc/examples/options.* build
+  perl tool/batch-benchmark doc/examples/options.* build
 
 To run lots of benchmarks:
 
-perl tool/batch-benchmark doc/examples/options.* benchmark
+  perl tool/batch-benchmark doc/examples/options.* benchmark