Skip to content
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

Merged
merged 3 commits into from Oct 11, 2017

Conversation

olivergondza
Copy link
Member

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

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
Copy link
Member

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.
Copy link
Member

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)
Copy link
Member

Choose a reason for hiding this comment

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

typo

Copy link
Member

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
Copy link
Member

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
Copy link
Member

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.

@olivergondza
Copy link
Member Author

Thanks for the review, Jesse.

@olivergondza olivergondza merged commit 6383cba into jenkinsci:master Oct 11, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants