Updated the MD files

Author: VinayKumar VVS

ReadMe.md

@@ -1,8 +1,8 @@
 ## API Automation Tutorial
 
-In this tutorial you are going to learn <b>How to Automate the API Tests</b> using <b>RESTAssured Library</b>
+In this tutorial you are going to learn <b>How to Automate the REST API's in Java</b> using <b>RESTAssured Library</b>
 
-This project contains automated API tests explained step by step. The tech stack used for this project are:
+The tech stack used for this tutorial are:
 1. **JAVA** as the programming language for writing test code
 2. **TestNg** as the framework
 3. **Gradle** as the build tool
@@ -32,20 +32,20 @@ Setup your machine.
 ### PetStore - Swagger
 Throughout this tutorial, I am going to use [PetStore-Swagger](http://petstore.swagger.io/). <b>PetStore - Swagger</b> is the open source project which has very good documentation with the various number of examples.
 
-#### [Chapter 1](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter01/Chapter01.md)
+#### [Chapter 1](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter01/Chapter01.md) :: Send a GET Request and validate the Response
 1. **[Test-1](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter01/FirstChapterTests.java):** Send a get Request of an API and validate the body
 2. **[Test-2](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter01/FirstChapterTests.java):** Send a get Request of an API by passing the Query Parameters in the URL itself
 3. **[Test-3](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter01/FirstChapterTests.java):** Send a get Request of an API and retrieve the data from the body
 4. **[Test-4](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter01/FirstChapterTests.java):** Send a get Request of an API and store the Response
 
-#### [Chapter 2](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter02/Chapter02.md)
-1. **[Test-1](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter02/SecondChapterTests.java):** Optimized way to send the Request and receive the Response
+#### [Chapter 2](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter02/Chapter02.md) :: Abstracting the code
+1. **[Test-1](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter02/SecondChapterTests.java):** Abstracting the Requests for maintenance and readability
 
-#### [Chapter 3](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter03/Chapter03.md)
+#### [Chapter 3](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter03/Chapter03.md) :: POST Request creation and validating the Response Code
 1. **[Test-1](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter03/ThirdChapterTests.java):** Creating the POST Request and validating the Response Code
 
-#### [Chapter 4](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter04/Chapter04.md)
+#### [Chapter 4](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter04/Chapter04.md) :: POST Request creation and validating RequestBody & ResponseBody
 1. **[Test-1](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter04/FourthChapterTests.java):** Creating the POST Request and validating the RequestBody & ResponseBody
 
-#### [Chapter 5](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter05/Chapter05.md)
-1. **[Test-1](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter05/FifthChapterTests.java)** Creating a Pet using POST method and verifying it by using GET method
+#### [Chapter 5](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter05/Chapter05.md) :: Chaining the API's
+1. **[Test-1](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter05/FifthChapterTests.java)** Chaining Requests and validate Response Body

src/test/java/Chapters/Chapter01/Chapter01GradleConfig.md

@@ -1,6 +1,6 @@
 ## Gradle Configuration
 
-This file is used to download all the dependencies that are required for this tutorial
+``Gradle is a build tool used to manage all the dependencies``
 
 #### Add the following Dependencies in `build.gradle`
 1. `testCompile group: 'org.testng', name: 'testng', version: '6.14.3'` - For TestNG
@@ -13,10 +13,10 @@ After adding the dependencies your block should look like
 
 #### Create a task for running tests from the command line
 * Add the following lines of code in your `build.gradle` file
-* This lines will make you execute all the tests present in the project.
+* This will make you execute all the tests present in the project from command line with `@Test` Annotation.
 
 ![](https://i.imgur.com/OPxH4hv.png)
 
-#### Now total Gradle file should look like
+#### Now, the Gradle file should be:
 
 ![](https://i.imgur.com/LvkwUPW.png)

src/test/java/Chapters/Chapter02/Chapter02.md

@@ -23,10 +23,10 @@ In order to optimize the code, we have introduced the following Java Files.
 
 #### **Tests**
 This Chapter consists only one test
-1. **Test-1:** Optimized way to send the Request and receive the Response
+1. **Test-1:** Abstracting the Requests for maintenance and readability
 
 #### Summary
-These are the following things we have learned from [Chapter 1](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter01/Chapter01.md) 
+Things we have learned so far from [Chapter 1](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter01/Chapter01.md) 
 and [Chapter 2](https://github.com/vinaykumarvvs/api-automation-tutorial/tree/master/src/test/java/Chapters/Chapter02/Chapter02.md) 
 1. How to send the Request and receive the Response.
 2. How to segregate the code based on their functionality by following `Single Responsibility Principle`.

src/test/java/Chapters/Chapter02/SecondChapterTests.java

@@ -8,9 +8,9 @@
 
 public class SecondChapterTests extends BaseTest {
 
- // Optimized way to send a Request and receive the Response
+ // Abstracting the code for more readability and maintainability
  @Test
- public void optimizedWayToSendReqAndReceiveResponse() {
+ public void abstractingTheRequestForMaintenanceAndReadability() {
  Response response = ResourceHelper.get(propertiesReader.getEndPointUrl("get_animals"));
  Assert.assertEquals(response.getStatusCode(), 200);
  }

src/test/java/Chapters/Chapter03/Chapter03.md

@@ -5,7 +5,7 @@
 * If you are reading this line then you are good to go. Let's get started with the <b>Third Chapter</b>
 
 #### **Quick Recap**
-Here are some listing, we have learned till now
+Here are some listings, we have learned till now
 1. How to send a GET Request
 2. How to validate the Response 
 3. And also we have seen, How to segregate the things in order to maintain `Single Responsibility Principle`.
@@ -44,14 +44,14 @@ This Chapter consists only one test
 
  In this test, we are doing the following actions:<br/>
 
- a. Creating an object for <b>Category</b> with some data <br/>
- b. Creating an object for <b>Tags</b> with some data and inserting in the TagsList<br/>
- c. Now we are creating the main object <b>CreatePetRequest</b><br/>
- d. After creating the all objects, we are converting the object into String and sending it to the server<br/>
- e. Validating the Response StatusCode<br/>
+ a. Create an object for <b>Category</b> with some data <br/>
+ b. Create an object for <b>Tags</b> with some data and inserting in the TagsList<br/>
+ c. Now create a main object <b>CreatePetRequest</b><br/>
+ d. Then serialize the object into JSON String and sending it in the body<br/>
+ e. Validate the Response Status-Code<br/>
 
 #### **Summary**
-These are the things that we have learned till now 
+Things we have learned so far:
 1. How to send the GET Request and receive the Response.
 2. How to segregate the code based on their functionality by following `Single Responsibility Principle`.
 3. How to create and send the POST Request using `Entity-Builder` pattern.

src/test/java/Chapters/Chapter04/Chapter04.md

@@ -12,16 +12,16 @@ Here are some listing, we have learned till now
 4. And also, How to send the POST Request using Entity-Builder pattern and validate the Response Code.
 
 #### **Agenda for this Chapter**
-Till now we have how to send a POST Request and validate only the Response Code, Do you think is this sufficient?. 
-No right!!. Don't worry in this chapter we are going to validate the Response body also. So let's get started.
+Till now we know how to send a POST Request and validate only the Response Code, Do you think is this sufficient?. 
+Don't worry in this chapter we are going to validate the Response body as well. So let's get started.
 
 #### **Response JSON**
 Here is the Response JSON, this JSON will be output when we POST the Request to server.
 
 ![](https://i.imgur.com/hQ0WTZB.png) 
 
 #### **Create Entities**
-1. As we have seen the Response JSON in the above picture, we clearly observe that in Response JSON also 
+1. As we have seen the Response JSON in the above picture, we can clearly observe that in Response JSON also 
 we have three Objects `Category, Tags & Main Object`. These objects are very similar to the one which we have created 
 for the POST method.
 2. We can use the same one, but this approach is not recommended. Because if someday Request changes and Response is not changed 
@@ -42,15 +42,15 @@ This Chapter consists only one test
 
  In this test, we are doing the following actions:<br/>
 
- a. Creating an object for <b>Category</b> with some data <br/>
- b. Creating an object for <b>Tags</b> with some data and inserting in the TagsList<br/>
- c. Now we are creating the main object <b>CreatePetRequest</b><br/>
- d. After creating the all objects, we are converting the object into String and sending it to the server<br/>
- e. Once we receive the Response, with the help of <b>ResponseHelper</b> we can map JSON String to Java Object<br/> 
- f. Verifying the attributes from <b>RequestBody</b> & <b>ResponseBody</b>
+ a. Create an object for <b>Category</b> with some data <br/>
+ b. Create an object for <b>Tags</b> with some data and inserting in the TagsList<br/>
+ c. Now create a main object <b>CreatePetRequest</b><br/>
+ d. Then serialize the object into JSON String and sending it in the body<br/>
+ e. Once we receive the Response, with the help of <b>ResponseHelper</b> we can de-serialize JSON String to Java Object<br/> 
+ f. Verify the attributes from <b>RequestBody</b> & <b>ResponseBody</b>
 
 #### **Summary**
-These are the things that we have learned till now 
+Things we have learned so far: 
 1. How to send the GET Request and receive the Response.
 2. How to segregate the code based on their functionality by following `Single Responsibility Principle`.
 3. How to create and send the POST Request using `Entity-Builder` pattern.

src/test/java/Chapters/Chapter05/Chapter05.md

@@ -14,32 +14,30 @@ Here are some listing, we have learned till now
 
 #### **Agenda for this Chapter**
 * Till now we have seen how to send a Request and receive the Response, and their validations. Now we are going to see 
-<b>How to Chain the API's</b>. What is Chaining? It is a process where we can pass 
-the information from one HTTP method to other HTTP method.
+<b>How to Chain the API's</b>. What is Chaining? It is a process where we can pass the information from one HTTP Request to other HTTP Requests.
 
 #### **Tests**
 This Chapter consists only one test
-1. **Test-1:** Creating a Pet using POST method and verifying it by using GET method
+1. **Test-1:** Chaining Requests and validate Response Body
 
  In this test, we are doing the following actions:<br/>
- <b>POST Request</b><br/>
-  a. Creating an object for <b>Category</b> with some data <br/>
-  b. Creating an object for <b>Tags</b> with some data and inserting in the TagsList<br/>
-  c. Now we are creating the main object <b>CreatePetRequest</b><br/>
-  d. After creating the all objects, we are converting the object into String and sending it to the server<br/>
-  e. Once we receive the Response, with the help of <b>ResponseHelper</b> we can map JSON String to Java Object<br/> 
-  f. Verifying the attributes from <b>RequestBody</b> & <b>ResponseBody</b>
+ <b>POST Request</b><br/> 
+ a. Create an object for <b>Category</b> with some data <br/>
+ b. Create an object for <b>Tags</b> with some data and inserting in the TagsList<br/>
+ c. Now create a main object <b>CreatePetRequest</b><br/>
+ d. Then serialize the object into JSON String and sending it in the body<br/>
+ e. Once we receive the Response, with the help of <b>ResponseHelper</b> we can de-serialize JSON String to Java Object<br/> 
+ f. Verify the attributes from <b>RequestBody</b> & <b>ResponseBody</b> 
 
  <b>GET Request</b><br/>
  g. Creating a GET Request using the PetId and verifying the other data
 
-```Similarly we can chain the other HTTP Methods as well. Like POST -> GET -> PUT -> DELETE ..```
+```Similarly, we can chain the HTTP Requests with other methods as well. Like POST -> GET -> PUT -> DELETE ..```
 
 #### **Summary**
-These are the things that we have learned till now 
+Things we have learned so far:
 1. How to send the GET Request and receive the Response.
 2. How to segregate the code based on their functionality by following `Single Responsibility Principle`.
 3. How to create and send the POST Request using `Entity-Builder` pattern.
 4. How to verify the RequestBody & ResponseBody
-5. How to chain the API's
- 
+5. How to chain the API's

src/test/java/Chapters/Chapter05/FifthChapterTests.java

@@ -20,7 +20,7 @@
 public class FifthChapterTests extends BaseTest {
 
  @Test
- public void createPetAndVerifyTheCreationUsingGETMethod() throws IOException {
+ public void chainingRequestsAndValidatingTheResponse() throws IOException {
 
  // Creating the Category Object
  Category category = new CategoryBuilder()