From 0eb69186f0b22f0e4bd5d6f1b4e31252bf614b76 Mon Sep 17 00:00:00 2001
From: Noah Eisen <ncteisen@gmail.com>
Date: Fri, 16 Dec 2016 15:28:22 -0800
Subject: [PATCH] Addressed github comments

---
 ...egative-http2-interop-test-descriptions.md | 93 ++++++++++---------
 1 file changed, 47 insertions(+), 46 deletions(-)

diff --git a/doc/negative-http2-interop-test-descriptions.md b/doc/negative-http2-interop-test-descriptions.md
index a06c00710f7..38aaa95a796 100644
--- a/doc/negative-http2-interop-test-descriptions.md
+++ b/doc/negative-http2-interop-test-descriptions.md
@@ -20,7 +20,7 @@ Server should accept these arguments:
 Client
 ------
 
-Clients implement test cases that test certain functionally. Each client is
+Clients implement test cases that test certain functionality. Each client is
 provided the test case it is expected to run as a command-line parameter. Names
 should be lowercase and without spaces.
 
@@ -51,18 +51,18 @@ the user application having to do a thing.
 Client Procedure:
  1. Client sends two UnaryCall requests with:
  
-     ```
+    ```
     {
-      response_size: 1024
+      response_size: 314159
       payload:{
-        body: 1024 bytes of zeros
+        body: 271828 bytes of zeros
       }
     }
     ```
 
 Client asserts:
-* call was successful.
-* response payload body is 1024 bytes in size.
+* Call was successful.
+* Response payload body is 1024 bytes in size.
 
 Server Procedure:
   1. Server sends a GOAWAY after receiving the first UnaryCall.
@@ -72,29 +72,29 @@ Server asserts:
 
 ### rst_after_header
 
-This test verifies that the client fails "correctly" when the server sends a
+This test verifies that the client fails correctly when the server sends a
 RST_STREAM immediately after sending headers to the client.
 
 Procedure:
  1. Client sends UnaryCall with:
  
-  ```
-  {
-    response_size: 1024
-    payload:{
-      body: 1024 bytes of zeros
+    ```
+    {
+      response_size: 314159
+      payload:{
+        body: 271828 bytes of zeros
+      }
     }
-  }
-  ```
+    ```
 
 Client asserts:
-* Call was not successful
+* Call was not successful.
 
 Server Procedure:
   1. Server sends a RST_STREAM with error code 0 after sending headers to the client.
   
 *At the moment the error code and message returned are not standardized throughout all
-languages. Those checks will be added once all client languages behave the same way.*
+languages. Those checks will be added once all client languages behave the same way. [#9142](https://github.com/grpc/grpc/issues/9142) is in flight.*
 
 ### rst_during_data
 
@@ -104,17 +104,17 @@ RST_STREAM halfway through sending data to the client.
 Procedure:
  1. Client sends UnaryCall with:
  
-  ```
-  {
-    response_size: 1024
-    payload:{
-      body: 1024 bytes of zeros
+    ```
+    {
+      response_size: 314159
+      payload:{
+        body: 271828 bytes of zeros
+      }
     }
-  }
-  ```
+    ```
 
 Client asserts:
-* Call was not successful
+* Call was not successful.
 
 Server Procedure:
   1. Server sends a RST_STREAM with error code 0 after sending half of 
@@ -127,17 +127,18 @@ RST_STREAM after sending all of the data to the client.
 
 Procedure:
  1. Client sends UnaryCall with:
-  ```
-  {
-    response_size: 1024
-    payload:{
-      body: 1024 bytes of zeros
+ 
+    ```
+    {
+      response_size: 314159
+      payload:{
+        body: 271828 bytes of zeros
+      }
     }
-  }
-  ```
+    ```
 
 Client asserts:
-* Call was not successful
+* Call was not successful.
 
 Server Procedure:
   1. Server sends a RST_STREAM with error code 0 after sending all of the
@@ -155,14 +156,14 @@ server.
 Procedure:
  1. Client sends UnaryCall with:
  
-  ```
-  {
-    response_size: 1024
-    payload:{
-      body: 1024 bytes of zeros
+    ```
+    {
+      response_size: 314159
+      payload:{
+        body: 271828 bytes of zeros
+      }
     }
-  }
-  ```
+    ```
   
 Client asserts:
 * call was successful.
@@ -170,24 +171,24 @@ Client asserts:
 
 Server Procedure:
   1. Server tracks the number of outstanding pings (i.e. +1 when it sends a ping, and -1 
-  when it receives an ack from the client)
-  2. Server sends pings before and after sending headers, also before and after sending data
+  when it receives an ack from the client).
+  2. Server sends pings before and after sending headers, also before and after sending data.
   
 Server Asserts:
-* Number of outstanding pings is 0 when the connection is lost
+* Number of outstanding pings is 0 when the connection is lost.
 
 ### max_streams
 
-This test verifies that the client observes the MAX_CONCURRENT_STREAMS limit set by the server
+This test verifies that the client observes the MAX_CONCURRENT_STREAMS limit set by the server.
 
 Client Procedure:
   1. Client sends initial UnaryCall to allow the server to update its MAX_CONCURRENT_STREAMS settings.
-  2. Client asynchronously sends 15 UnaryCalls
+  2. Client concurrently sends 10 UnaryCalls.
   
 Client Asserts:
-* All UnaryCalls were successful, and had the correct type and payload size
+* All UnaryCalls were successful, and had the correct type and payload size.
  
 Server Procedure:
-  1. Sets MAX_CONCURRENT_STREAMS to one after the connection is made
+  1. Sets MAX_CONCURRENT_STREAMS to one after the connection is made.
 
 *The assertion that the MAX_CONCURRENT_STREAMS limit is upheld occurs in the http2 library we used.*