Skip to content

[Security Solution] Cypress documentation updates#86835

Merged
rylnd merged 9 commits intoelastic:masterfrom
rylnd:cypress_documentation_updates
Jan 5, 2021
Merged

[Security Solution] Cypress documentation updates#86835
rylnd merged 9 commits intoelastic:masterfrom
rylnd:cypress_documentation_updates

Conversation

@rylnd
Copy link
Copy Markdown
Contributor

@rylnd rylnd commented Dec 22, 2020

Summary

  • Updates Cypress README with latest/greatest
  • Adds link to said README in x-pack/README.md

For maintainers

* Fixes some whitespace/grammar/typos
* Condenses the explanation/instructions for the different modes of
  execution
This is a big sprawling file; trying to cut down on the noise.
This is going to be what 90% of readers are looking for, methinks.
This file was moved as part of elastic#64368.
This file was deleted in elastic#67138.
@rylnd rylnd added v8.0.0 release_note:skip Skip the PR/issue when compiling release notes v7.11.0 Team:Detections and Resp Security Detection Response Team Team: SecuritySolution Security Solutions Team working on SIEM, Endpoint, Timeline, Resolver, etc. labels Dec 22, 2020
@rylnd rylnd self-assigned this Dec 22, 2020
@rylnd rylnd requested review from a team as code owners December 22, 2020 20:39
See [here](./test/functional/apps/dashboard/reporting/README.md) for more information on running reporting tests.

#### Running Security Solution Cypress E2E/integration tests
See [here](./plugins/security_solution/cypress/README.md) for information on running this test suite.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tylersmalley I added this link here since this file was linked from the current docs, but it looks like that reference is gone in 7.11.

Any preference on where/how to reference this in the 7.11 documentation?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it's fine only backporting to 7.x/7.12.

Copy link
Copy Markdown
Contributor

@dhurley14 dhurley14 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think I saw two typos but other than that this looks accurate! LGTM. Thanks for taking this on @rylnd 👍

Co-authored-by: Devin W. Hurley <snowmiser111@gmail.com>
Copy link
Copy Markdown
Contributor

@banderror banderror left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Than's just great!

I wish this doc was available to me when I first started writing Cypress tests recently. While the doc definitely was not bad at all and gave me relevant info (especially comparing to other docs on dev tooling), I had to figure out what test modes exist, what's the proper way to run all tests, develop a new one, etc etc. Wasted some time on trying to run Cypress against my own instance of ES; trying to run a single test in headless mode; thought I was missing some env vars; found a "bug" in start-cypress-open etc.

I especially appreciate that the doc starts from high level (what is that and how to use it) and then goes into details of implementation.

👏

rylnd added 2 commits January 4, 2021 16:29
 Conflicts:
	x-pack/plugins/security_solution/cypress/README.md
@rylnd rylnd added v7.12.0 and removed v7.11.0 labels Jan 4, 2021
@rylnd rylnd merged commit 1363a2a into elastic:master Jan 5, 2021
@rylnd rylnd deleted the cypress_documentation_updates branch January 5, 2021 00:47
rylnd added a commit to rylnd/kibana that referenced this pull request Jan 5, 2021
* Update/refactor some cypress documentation

* Fixes some whitespace/grammar/typos
* Condenses the explanation/instructions for the different modes of
  execution

* Condense Artifacts section

This is a big sprawling file; trying to cut down on the noise.

* Move test-running section to top of README

This is going to be what 90% of readers are looking for, methinks.

* Adds Security Solution's cypress suite to x-pack testing README

* Fix broken link

This file was moved as part of elastic#64368.

* Remove broken link

This file was deleted in elastic#67138.

* Apply suggestions from code review

Co-authored-by: Devin W. Hurley <snowmiser111@gmail.com>

* Fix typo

Co-authored-by: Devin W. Hurley <snowmiser111@gmail.com>
rylnd added a commit that referenced this pull request Jan 5, 2021
* Update/refactor some cypress documentation

* Fixes some whitespace/grammar/typos
* Condenses the explanation/instructions for the different modes of
  execution

* Condense Artifacts section

This is a big sprawling file; trying to cut down on the noise.

* Move test-running section to top of README

This is going to be what 90% of readers are looking for, methinks.

* Adds Security Solution's cypress suite to x-pack testing README

* Fix broken link

This file was moved as part of #64368.

* Remove broken link

This file was deleted in #67138.

* Apply suggestions from code review

Co-authored-by: Devin W. Hurley <snowmiser111@gmail.com>

* Fix typo

Co-authored-by: Devin W. Hurley <snowmiser111@gmail.com>

Co-authored-by: Devin W. Hurley <snowmiser111@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

release_note:skip Skip the PR/issue when compiling release notes Team:Detections and Resp Security Detection Response Team Team: SecuritySolution Security Solutions Team working on SIEM, Endpoint, Timeline, Resolver, etc. v7.12.0 v8.0.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants