Update README.md.

Greg Brown · Greg Brown · commit fe1766b4da41 · 2015-12-06T11:37:31.000-05:00
diff --git a/README.md b/README.md
@@ -21,7 +21,7 @@ Return values may be any JSON type, including string, number, boolean (true/fals
 
 An HTTP 200 is returned on successful completion, and HTTP 500 is returned in the case of an error (i.e. an exception). Note that exceptions are intended to represent unexpected failures, not application-specific errors. No other HTTP status codes are supported.
 
-Services may return a optional JSON descriptor that documents the methods provided by the service. If supported, a GET request for the base service URL should produce a response of the following form:
+Services may return a optional JSON descriptor that documents the methods provided by the service. If supported, the descriptor should be of the following form, and should be returned by a GET request for the base service URL:
 
     [
       {
@@ -40,11 +40,7 @@ Services may return a optional JSON descriptor that documents the methods provid
       ...
     ]
 
-For example, a GET for the following URL:
-
-    http://example.com/rpc/math
-
-might produce a response similar to the following:
+For example, a descriptor for the hypothetical math service might look something like this:
 
     [
       {
@@ -78,6 +74,10 @@ might produce a response similar to the following:
       }
     ]
     
+and could be obtained by a request for the following URL:
+
+    http://example.com/rpc/math
+    
 ## Implementations
 Support currently exists for implementing HTTP-RPC services in Java, and consuming services in Java, Objective-C/Swift, or JavaScript. Support for other platforms may be added in the future. Contributions are welcome.
 

Original file line number	Diff line number	Diff line change
`@@ -21,7 +21,7 @@ Return values may be any JSON type, including string, number, boolean (true/fals`
`21`	`21`
`22`	`22`	`An HTTP 200 is returned on successful completion, and HTTP 500 is returned in the case of an error (i.e. an exception). Note that exceptions are intended to represent unexpected failures, not application-specific errors. No other HTTP status codes are supported.`
`23`	`23`
`24`		`-Services may return a optional JSON descriptor that documents the methods provided by the service. If supported, a GET request for the base service URL should produce a response of the following form:`
	`24`	`+Services may return a optional JSON descriptor that documents the methods provided by the service. If supported, the descriptor should be of the following form, and should be returned by a GET request for the base service URL:`
`25`	`25`
`26`	`26`	`[`
`27`	`27`	`{`
`@@ -40,11 +40,7 @@ Services may return a optional JSON descriptor that documents the methods provid`
`40`	`40`	`...`
`41`	`41`	`]`
`42`	`42`
`43`		`-For example, a GET for the following URL:`
`44`		`-`
`45`		`- http://example.com/rpc/math`
`46`		`-`
`47`		`-might produce a response similar to the following:`
	`43`	`+For example, a descriptor for the hypothetical math service might look something like this:`
`48`	`44`
`49`	`45`	`[`
`50`	`46`	`{`
`@@ -78,6 +74,10 @@ might produce a response similar to the following:`
`78`	`74`	`}`
`79`	`75`	`]`
`80`	`76`
	`77`	`+and could be obtained by a request for the following URL:`
	`78`	`+`
	`79`	`+ http://example.com/rpc/math`
	`80`	`+`
`81`	`81`	`## Implementations`
`82`	`82`	`Support currently exists for implementing HTTP-RPC services in Java, and consuming services in Java, Objective-C/Swift, or JavaScript. Support for other platforms may be added in the future. Contributions are welcome.`
`83`	`83`