Update replication-controller docs

Adds a document on pod templates that can be shared
between various controller docs.

Move more philosophical content to later in the doc.

Add more task-oriented stuff earlier.

Put example config in the document, early on, so users have something concrete to relate the discussion of fields to.

Link to Job and DaemonSet docs.

Make format more like that of Job and DaemonSet docs.

Use jsonpath in examples, which is available in v1.1.

Added example files.

examples/examples_test.go

@@ -230,6 +230,7 @@ func TestExampleObjectSchemas(t *testing.T) {
 			"ingress":              &extensions.Ingress{},
 			"nginx-deployment":     &extensions.Deployment{},
 			"new-nginx-deployment": &extensions.Deployment{},
+			"replication":          &api.ReplicationController{},
 		},
 		"../docs/admin": {
 			"daemon": &extensions.DaemonSet{},