Use Markdown for READMEs. Add Travis badge to root README.

README.md

@@ -0,0 +1,7 @@
+# Jsonnet - The data templating language
+
+[![Build Status](https://travis-ci.org/google/jsonnet.svg?branch=master)](https://travis-ci.org/google/jsonnet)
+
+Website: http://google.github.io/jsonnet/doc/
+
+Discussion Forum: https://groups.google.com/forum/#!forum/jsonnet

case_studies/kubernetes/README.md

@@ -0,0 +1,21 @@
+# Kubernetes Example
+
+This Kubernetes example is based on https://github.com/vasanthbala/hackathon/tree/master/kbp/redis
+
+Generate the yaml (actually json) files for Kubernetes:
+
+```sh
+jsonnet -m example.jsonnet
+```
+
+Check they are the same as the original handwritten files:
+
+```sh
+python test_same.py
+```
+
+Clean up
+
+```sh
+rm -v *.out *.new.yaml
+```

test_suite/README → test_suite/README.md

@@ -1,17 +1,15 @@
-=============
-Test programs
-=============
+# Test programs
 
-Run ./run_tests.sh to run the full suite and report results.
+Run `./run_tests.sh` to run the full suite and report results.
 
 The tests are executed with very aggressive garbage collection parameters.  A full garbage
 collection cycle is run on every allocation.  This means if an object is freed by the GC but still
 referenced (because the reference was not from the stack / heap) then the error can be caught in
 valgrind.
 
-The output of each test (merging stdout and stderr with 2>&1) should match its .golden file.  If a
-test has no .golden file, the test should return "true".  If a test's name begins with "error." then
+The output of each test (merging `stdout` and `stderr` with `2>&1`) should match its .golden file.  If a
+test has no `.golden` file, the test should return "true".  If a test's name begins with "error." then
 its exit code is expected to be 1, otherwise it should be 0.
 
 If a test is changed, and its golden output needs to be updated (e.g. line numbers in stack traces
-no-longer match up) then run ./refresh_golden.sh <thetest.jsonnet>
+no-longer match up) then run `./refresh_golden.sh <thetest.jsonnet>`