From c276395f496b6578b3bee0a8eeb69531b6175e45 Mon Sep 17 00:00:00 2001
From: RachelElysia <71795832+RachelElysia@users.noreply.github.com>
Date: Fri, 11 Jun 2021 18:41:27 -0400
Subject: [PATCH] Update Cypress README.md (#1071)

---
 cypress/README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/cypress/README.md b/cypress/README.md
index deed92bde8..80a15351df 100644
--- a/cypress/README.md
+++ b/cypress/README.md
@@ -1,5 +1,6 @@
 # Cypress Testing
 
+Cypress tests are designed solely for end-to-end testing. If this is your first time developing or running end-to-end tests, [Fleet testing documentation](https://github.com/fleetdm/fleet/blob/main/docs/4-Contribution/2-Testing.md) includes git instructions for test preparation and running tests.
 ## Opening Cypress locally
 
 To open simply run:
@@ -8,3 +9,18 @@ To open simply run:
 
 This will open up cypress locally and
 allow you to view the current test suite, as well as start writing new test. 
+## Bulding best practices
+
+As much as possible, build from a user's perspective. Use .within cypress command as needed to scope a command within a specific element (e.g. <table>, <nav>).
+
+As much as possible, assert that the code is only selecting 1 item or that the final assertion is the appropriate count.
+### Prioritization of selecting elements
+
+1. By **element tag** using elements (e.g. buttons), we can target text within. Confirm what the user is seeing with target text. If this is not specific enough, add on Role.
+2. By **role** using default or explicitly assigned roles of elements. If this is not specific enough, add on element class. 
+3. By **element class** is least preferred as it does not follow a user's perspective. Occassionally this may be the only option. If that is the case, prioritize using the class name that specifies what the element is doing.  
+## Resources
+
+- [Fleet testing documentation](https://github.com/fleetdm/fleet/blob/main/docs/4-Contribution/2-Testing.md)
+- [Cypress documentation](https://docs.cypress.io/api/table-of-contents)
+- [React testing-library query documentation](https://testing-library.com/docs/queries/about)