Update Overview in README

Author: Serhat Bolsu

README.md

@@ -4,9 +4,29 @@ Restful API testing sample framework. ATDD is the suggested design pattern with
 Jest is chosen since it is sharing the same `expect` library with webdriverio. 
 It is much faster then mocha due to inherent parallelization. 
 
-## Goal
-
-TBA
+## Overview
+
+In this framework, you will find test suites for included restful api "Vegetable" service. 
+You will find three suites that are representing different design choices
+- Test suite using super agent.
+- Test suite using base api which represent DSL of 'Vegetable' application.
+- Test suite using Resource Objects, explained below.
+
+You can copy this library and use as you like, however think about the design choices you are changing.
+
+Technology | Description
+---------- | -----------
+Acceptance Test Driven Development | ATDD involves team members with different perspectives (customer, development, testing) collaborating to write acceptance cases.
+Resource Objects | Design pattern like Page Object, represent each endpoint as resource
+Code as commit | Everything about test automation should be committed, including CI
+
+Tools | Description
+--- | ---
+superagent | Request is a library for making HTTP requests. This will be used for making the HTTP requests in the tests
+jest | Jest is a test executor that is running async. It includes assertion library.
+eslint | Static code analysis tool for Javascript
+husky | Regulate code commit (with linter in this case)
+express | Express is popular HTTP framework for NodeJS which will be used for creating the System Under Test.
 
 ## Setup
 First need to create your own configurations.
@@ -15,15 +35,15 @@ Copy the sample.env and rename to `.env`
 
 ```npm install```
 
-- Run tests in local
-
-```npm test```
-
 In case you want to run against sample api *Vegetables*, 
 run the server with
 
 ```npm start```
 
+Run tests in local
+
+```npm test```
+
 ## Test Suites and Example usage
 These are example usages of library. From 1 to 3 abstraction of endpoints increases.
 
@@ -51,6 +71,40 @@ Uses resource object, this is a similar method used in selenium with **page Obje
 - usage of superagent/requests encapsulated, however still usable look at tc#3
 - Pre-initialized resource-objects, it serve as a facade to service under test.
 
+## Familiarizing Yourself with the System Under Test
+
+It's always necessary to get to know the code you are testing. 
+Let us examine the API that we are testing. The purpose of the API is to be an interface with a vegetable database. 
+Supports the following operations:
+
+- Adding a vegetable
+- Deleting a vegetable
+- Getting all vegetables
+
+The API supports adding and deleting individual vegetables. You can also get all vegetables in the database. Here are the API routes:
+
+* GET /vegetables
+ * Description
+ * Get all the vegetables in the database
+ * Query Parameters
+ * upperCase
+ * If set to "true" the vegetable's name will be return uppercase
+ * Default is false
+ * optional
+ * If set to "true", return will include optional: `origin`
+ * Default is true
+
+* POST /vegetables
+ * Description
+ * Add a vegetable to the database
+
+* DELETE /vegetables/:id
+ * Description
+ * Delete a vegetable from the database
+ * Url Parameters
+ * name
+ * The name of the vegetable to delete 
+
 ## ToDO
 - Allure reporting
 - Jenkinsfile