Skip to content

Commit e999194

Browse files
committed
update docs
1 parent 5daa949 commit e999194

File tree

2 files changed

+18
-10
lines changed

2 files changed

+18
-10
lines changed

CHANGELOG.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
1+
### 2.5.0 (2018-04-02)
12
* Update gradle 4.1 -> 4.6
23
* Update gradle-quality-plugin 2.3.0 -> 3.0.0
34
* Update gradle-animalsniffer-plugin 1.4.1 -> 1.4.3

README.md

Lines changed: 17 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,8 @@ Features:
1515
* [Maven central](http://search.maven.org/) compatible artifacts (jar, sources, javadocs)
1616
* Ready for [spock](http://spockframework.org) tests ([documentation](http://docs.spockframework.org))
1717
* [Bintray](https://bintray.com/) publication (+ jars signing and maven central publishing)
18-
* [Travis-ci](https://travis-ci.org/) integration (CI and healthy badge)
19-
* [Coveralls](http://coveralls.io/) integration (code coverage badge)
18+
* CI: [travis](https://travis-ci.org/) (linux), [appveyor](https://www.appveyor.com/) (windows)
19+
* Coverage with jacoco, merged from both win and linux builds in [codecov.io](https://codecov.io/)
2020
* Target jdk compatibility check with [animal sniffer](http://mojo.codehaus.org/animal-sniffer/) (you may use newer jdk to build, and keep compatibility with older jdk)
2121
* Code quality checks ([checkstyle](http://checkstyle.sourceforge.net/), [pmd](http://pmd.sourceforge.net/), [findbugs](http://findbugs.sourceforge.net/))
2222
* [Release process](https://github.com/researchgate/gradle-release#introduction) (like maven release)
@@ -142,9 +142,12 @@ Create [github](https://github.com) repo matching your library name and push pro
142142

143143
In github project settings go to `Webhooks & services` and add `travis-ci` service.
144144

145-
Go to [travis](https://travis-ci.org/) and enable your repo.
145+
Enable repository on services:
146+
* [travis](https://travis-ci.org/)
147+
* [appveyor](https://www.appveyor.com/)
146148

147-
Go to [coveralls](http://coveralls.io/) and enable your repo.
149+
And after next commit windows and linux builds will be performed automatically and combined coverage report
150+
will be available on [codecov](https://codecov.io/) (badges for all services are already generated in readme).
148151

149152
Bintray and maven central badges are generated in readme, but commented (uncomment before release).
150153

@@ -169,6 +172,11 @@ will get much more feedback (something people will never post as issue or write
169172
Gitter badge is not generated automatically, because it's not required as other services and it's too easy to add at any time.
170173
Look it and decide if you need it.
171174

175+
### Documentation
176+
177+
You can use [gradle-mkdocs-plugin](https://github.com/xvik/gradle-mkdocs-plugin) for writing versioned project documentation
178+
(published on github pages).
179+
172180
### Project usage
173181

174182
```bash
@@ -225,7 +233,6 @@ Used gradle plugins:
225233
* [findbugs](http://www.gradle.org/docs/current/userguide/findbugs_plugin.html) to find potential bugs with [findbugs](http://findbugs.sourceforge.net/)
226234
* [com.jfrog.bintray](https://github.com/bintray/gradle-bintray-plugin) for bintray publishing
227235
* [com.github.ben-manes.versions](https://github.com/ben-manes/gradle-versions-plugin) to check dependencies versions updates
228-
* [com.github.kt3k.coveralls](https://github.com/kt3k/coveralls-gradle-plugin) to send coverage report to coveralls
229236
* [net.researchgate.release](https://github.com/researchgate/gradle-release) for release (see [article](http://www.sosaywecode.com/gradle-release-plugin/) for additional plugin details)
230237
* [ru.vyarus.pom](https://github.com/xvik/gradle-pom-plugin) for simpler pom generation
231238
* [ru.vyarus.java-lib](https://github.com/xvik/gradle-java-lib-plugin) to prepare java artifacts setup
@@ -240,13 +247,13 @@ Optional and provided dependencies support provided by [ru.vyarus.pom plugin](ht
240247
Example usage:
241248

242249
```groovy
243-
provided 'com.google.code.findbugs:jsr305:3.0.0'
250+
provided 'com.github.spotbugs:spotbugs-annotations:3.1.2'
244251
```
245252

246253
or
247254

248255
```groovy
249-
optional 'com.google.code.findbugs:jsr305:3.0.0'
256+
optional 'com.github.spotbugs:spotbugs-annotations:3.1.2'
250257
```
251258

252259
In generated pom these dependencies will be defined as provided or optional, but for gradle build it's
@@ -278,9 +285,9 @@ When no signatures defined, no check will be performed.
278285
Quality tools are configured by [ru.vyarus.quality plugin](https://github.com/xvik/gradle-quality-plugin).
279286

280287
Read more about quality tools specifics and how to suppress warnings:
281-
* [checkstyle](https://github.com/xvik/gradle-quality-plugin#checkstyle)
282-
* [pmd](https://github.com/xvik/gradle-quality-plugin#pmd)
283-
* [findbugs](https://github.com/xvik/gradle-quality-plugin#findbugs)
288+
* [checkstyle](http://xvik.github.io/gradle-quality-plugin/3.0.0/tool/checkstyle/)
289+
* [pmd](http://xvik.github.io/gradle-quality-plugin/3.0.0/tool/pmd/)
290+
* [spotbugs](http://xvik.github.io/gradle-quality-plugin/3.0.0/tool/spotbugs/)
284291

285292
By default, quality checks fail build if any violation found. In order to simply report violations do:
286293

0 commit comments

Comments
 (0)