Skip to content

Commit 4cc82a4

Browse files
Merge pull request #50 from jamesagardner/master
Adding contributor information
2 parents 9c80347 + 498b60c commit 4cc82a4

File tree

1 file changed

+30
-4
lines changed

1 file changed

+30
-4
lines changed

README.md

Lines changed: 30 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,16 +7,40 @@ provides a few new features:
77
1. A small Java library for integrating MarkLogic unit tests into existing test frameworks like JUnit
88
1. The ability to depend on this module as a true third-party dependency via ml-gradle
99

10-
To try this out locally, check out the [ml-gradle example project](https://github.com/marklogic-community/ml-gradle/tree/dev/examples/unit-test-project).
10+
To try this out locally, check out the
11+
[ml-gradle example project](https://github.com/marklogic-community/ml-gradle/tree/dev/examples/unit-test-project).
1112
You can use that project's build.gradle file as an example of how to use marklogic-unit-test in your own project.
1213

14+
# Contributing
15+
16+
Contributions are welcome. Here are some steps to get you started:
17+
1. Please start by forking the project on GitHub
18+
1. Check out your fork of the project
19+
1. Make your changes
20+
1. Add tests to cover your changes
21+
1. Make sure the tests pass by running `gradle build test`
22+
1. Check in your changes to your fork on GitHub
23+
1. Once the changes are ready, create a pull request
24+
1. Wait for the pull request to be reviewed and accepted into the baseline
25+
26+
## Testing
27+
Please make sure that all changes to the project include sufficient unit tests to cover the feature being added. Pull
28+
requests without automated tests will not be accepted.
29+
30+
Tests can be added to `{PROJECT}/marklogic-unit-test-client/src/test/ml-modules/root/test/suites` and can be ran with
31+
the `gradle build test` target.
32+
33+
If you're using an IDE with Junit support tests can be ran from the IDE by running the test at
34+
`{PROJECT}/marklogic-unit-test-client/src/test/java/com/marklogic/test/unit/ParameterizedTest.java`
35+
1336
## Releasing
1437

1538
To do a release:
1639

1740
1. Increment the `version` property in `{PROJECT}/gradle.properties`
1841
2. In `{PROJECT}/`, run `github_changelog_generator --token $your-github-token --future-release v1.0.0`
19-
- If running on Windows, you'll need to use different cache file paths, such as `--cache-file C:\tmp\github-changelog-http-cache --cache-log C:\tmp\github-changelog-logger.log`.
42+
- If running on Windows, you'll need to use different cache file paths, such as
43+
`--cache-file C:\tmp\github-changelog-http-cache --cache-log C:\tmp\github-changelog-logger.log`.
2044
3. Commit the CHANGELOG.md
2145
4. Push changes to GitHub
2246
5. Do a PR to bring changes from the develop branch onto master
@@ -31,5 +55,7 @@ To publish this project, you need to publish both marklogic-unit-test-modules an
3155
3. `gradle bintrayUpload`
3256
4. `cd ../marklogic-unit-test-modules`
3357
5. `gradle bintrayUpload`
34-
6. Open [marklogic-unit-test-modules](https://bintray.com/marklogic-community/Maven/marklogic-unit-test-modules) on Bintray and click "Publish"
35-
6. Open [marklogic-unit-test-client](https://bintray.com/marklogic-community/Maven/marklogic-unit-test-client) on Bintray and click "Publish"
58+
6. Open [marklogic-unit-test-modules](https://bintray.com/marklogic-community/Maven/marklogic-unit-test-modules) on
59+
Bintray and click "Publish"
60+
6. Open [marklogic-unit-test-client](https://bintray.com/marklogic-community/Maven/marklogic-unit-test-client) on
61+
Bintray and click "Publish"

0 commit comments

Comments
 (0)