New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Update README to reflect where we want ATH to be #364
Conversation
README.md
Outdated
master | stable | ||
------ | ------ | ||
[![Build Status](https://jenkins.ci.cloudbees.com/buildStatus/icon?job=core/acceptance-test-harness)](https://jenkins.ci.cloudbees.com/job/core/job/acceptance-test-harness/) | [![Build Status](https://jenkins.ci.cloudbees.com/buildStatus/icon?job=core/acceptance-test-harness-stable)](https://jenkins.ci.cloudbees.com/job/core/job/acceptance-test-harness-stable/) | ||
The scenarios are described as unit tests controlling Jenkins through UI / REST API. Clean instance is started for |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
They are not “unit” tests, just tests using the JUnit framework.
There is a bit of a delay since we bring up Jenkins for every single test, with | ||
it's own sandboxed workspace. | ||
The simplest way to start the harness is calling `BROWSER=firefox JENKINS_VERSION=latest mvn test`. Complete test suite | ||
takes hours to run due to the number of covered components/use-cases, the cost of Jenkins setup and selenium interactions. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
So offer a tip here on selecting smoke tests.
README.md
Outdated
* [Managing the versions of Jenkins and plugins](docs/SUT-VERSIONS.md) | ||
* [Using a http proxy](docs/USING-A-HTTP-PROXY.md) | ||
* [Prelaunchint JUT](docs/PRELAUNCH.md) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
typo
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
(and people will not know what “JUT” means; explained in the next item but that should be moved up)
README.md
Outdated
* [Running tests in container](docs/DOCKER.md) | ||
* Selecting tests based on plugins they cover (TODO) | ||
|
||
### Writing tests | ||
|
||
Given how log does it take for the suite to run, test authors are advised to focus on the most popular plugins and |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
s/log does it take/long it takes/
README.md
Outdated
* [Running tests in container](docs/DOCKER.md) | ||
* Selecting tests based on plugins they cover (TODO) | ||
|
||
### Writing tests | ||
|
||
Given how log does it take for the suite to run, test authors are advised to focus on the most popular plugins and | ||
use-cases to maximize the value of the test suite. Tests that can or already are written as a part of core/plugin tests |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Probably a good place to discuss what is and is not practical to do with JenkinsRule
and thus what the reasons would be for writing something using ATH.
Thanks for the review, Jesse. |
Documenting our new policy for test types we want ATH to hold as well as broken/flaky test eviction policy.
See https://groups.google.com/forum/#!topic/jenkinsci-dev/R8w7uhh-xbgfor discussion.
CC @jenkinsci/code-reviewers