Update README.md

Author: jespitiaa

README.md

@@ -2,3 +2,30 @@
 This repository contains the code for a random tester developed using [Cypress](https://www.cypress.io/). Two versions are developed, including a full random tester and a smarter random tester, and the differences between these two remain in the type of commands that each can execute. The detail is explained in sections below
 
 ## How to run
+In order to use the tester, you will have to follow these steps:
+- Get the source code from this repository: Click on Download as Zip and unzip the folder in your machine or clone the repo
+- Install the required modules: Using [Node Package Manager](https://www.npmjs.com/), run `npm install`. This will install the cypress and faker modules, besides a cypress [plugin](https://github.com/Bkucera/cypress-plugin-tab) for tab.
+- Configure the desired parameters: The repository's root folder contains two JSON files which have the configuration parameters for each test. Open them and edit the parameters as needed. You can change the baseURL, the percentage of events, the delay between events, and the number of events.
+- Run the desired tester: For the random tester, run `cypress run --config-file ./monkey-config.json`. For the slightly smarter random tester, run `cypress run --config-file ./smart-monkey-config.json`.
+
+## The testers
+Cypress is an E2E test runner built over JavaScript. We used this technology due to the facility for managing web pages in a variety of browsers including Chrome, Canary, Edge, Electron, etc. and the record-and-replay functionality. The idea of the first tester is to perform a completely random test on a web application, inspired on a similar tester, the [Android Monkey](https://developer.android.com/studio/test/monkey). The second tester exists due to the high rate of errors and low probability of getting events that change the application's state of the Monkey tester.
+
+## Events
+After evaluating a series of possible events, we defined the following 8 categories in which the events could be grouped by:
+- **Random Click Events**:
+Left, Right or Double clicks performed to an element from a random position
+- **Scroll Events**:
+Scrolling the page up, down, to the left or to the right.
+- **Selector Focus Events**:
+Focusing on elements from a random position, considering their HTML tags. The equivalent for pressing tab into a focusable element
+- **Keypress Events**:
+Introducing a character inside of a focused element. The equivalent for pressing a key from the keyboard when focusing an element.
+- **Special Keypress Events**:
+Typing special characters inside of a focused element. The special keys include Enter, Supr, Esc, Backspace, Arrows, and possible modifiers such as Shift, Alt or Ctrl.
+- **Page Navigation Events**:
+Typical navigation that an user could perform, go to the last page or to the next page in the navigation Stack.
+- **Browser Chaotic Events**:
+Events that change the browser configuration such as changing the viewport, clearing local storage or clearing the cookies.
+- **Selector Click Events**:
+Clicks performed to a specific type of element considering the HTML tags that typically induce an interaction such as <a>, <button>, <input type="submit">; also, events of filling and clearing an input element.