Update README.md

README.md

@@ -1,4 +1,12 @@
-# example tests using cypress __[and keeping it simple]__
+# Full E2E test suite with Cypress.io (for site:http://angularjs.realworld.io/) [WIP] 
+
+Goals:
+- keep it simple - no abstractions/functions/utils/helpers
+- tests are easily readable
+- project is easily understandable even to people without previous JS or Cypress knowledge
+
+![image](https://user-images.githubusercontent.com/48861601/110022516-af6f2400-7d34-11eb-8b13-f21789331cb3.png)
+
 
 # 1. Setup
 
@@ -21,17 +29,19 @@ cypress __headless mode__ (cypress run):
 
 # Information
 
-Goal is to have full E2E suite, that is easily understandable even to people without previous JS or Cypress knowledge.
-
 Tests are located in `cypress/integration` folder
 
 Configuration files:
-1. cypress.json
-2. plugins/index.js
+1. `cypress.json`
+2. `plugins/index.js`
 
 Custom commands (shortcuts) are located in `cypress/support` folder (`.cmd.js` suffix)
 
-Why mobile view is in config and not in test (like cy.viewport())?
+Selectors are located in `cypress/selectors` folder [only difference from cypress default project structure]
+- __not__ using page objects pattern but keeping selectors (only selectors) separately as they are not easily readable
+
+# Q&A
+1. Why mobile view is in config and not in test (like cy.viewport())?
 - we can't change userAgent in the middle of the test:
 https://github.com/cypress-io/cypress/issues/2100
 So it seems more correct to launch the tests with the correct config (--env device=mob/web)
@@ -39,6 +49,6 @@ So it seems more correct to launch the tests with the correct config (--env devi
 
 # __Following best practices__
 
-0. KISS [keep it simple, stupid]
-2. Using shortcuts to test only one feature at a time
-3. Tests are easily readable - __not__ using page objects pattern but keeping selectors (only selectors) separately as they are not easily readable
+1. https://www.youtube.com/watch?v=5XQOK0v_YRE&ab_channel=OKG%21
+2. https://docs.cypress.io/guides/references/best-practices.html
+3. https://docs.cypress.io/api/cypress-api/custom-commands.html#Best-Practices