diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..8bc1118 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,28 @@ +# Contributing # +## Why contributing? ## +The original author and all users of this library are very greatful for your contribution +to this Open Source Project. Also most employers value people active in the Open Source +community. + +## The Checklist ## +If you want to help out and contribute to this Open Source Project, please keep reading. + +My thought with `jadb` was to make it very light weight and easy to use as a developer. +This means as little boilerplate code, (mostly) self-documenting public interface, and +overall clean code. + +Before submitting a pull request, please go through the below checklist to verify +your proposed change meets, or exceeds, the quality of the jadb source code. + +* Builds - Make sure the code builds by issuing `ant build`. +* Works - Make sure all the test runs and passes. +* Works - Double check any features you might have changed, and of course any _new_ code + by testing manually. +* Formatting - Keep the formatting _consistent_. Nothing + fancy, pretty standard java stuff, check other source files + for reference. +* Readability - Is your code easy to read? This usually means shorter code, but don't go + full terse. +* Newline at end of file - This makes `cat`-ing files, etc easier. + +Happy coding! I, the original author, and all users are greatful for your contribution. :-) \ No newline at end of file diff --git a/README.md b/README.md index e469d98..f8805fb 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ This projects aims at providing an up to date implementation of the ADB protocol Usage cannot be simpler. Just create a `JadbConnection` and off you go. JadbConnection jadb = new JadbConnection(); - List devices = jadb.getDevices(); + List devices = jadb.getDevices(); Make sure the adb server is running. You can start it by running `adb` once from the command line. @@ -39,8 +39,8 @@ A list of the available commands that a ADB Server may accept can be found here: Since version v1.1 Jadb support [maven](https://maven.apache.org/) as a build system. Although this project is not presented in official apache maven repositories this library can be used as dependencies in your maven/gradle project with the help of [jitpack](https://jitpack.io). -[Оitpack](https://jitpack.io) is a system which parse github public repositories and make artifacts from them. -You will just only need to add [jitpack](https://jitpack.io) as a repository to let maven/gradle to search for artifacts in it +[Jitpack](https://jitpack.io) is a system which parses github public repositories and make artifacts from them. +You only need to add [jitpack](https://jitpack.io) as a repository to let maven/gradle to search for artifacts in it, like so ``` @@ -52,7 +52,7 @@ You will just only need to add [jitpack](https://jitpack.io) as a repository to ``` After that you will need to add actual dependency. [Jitpack](https://jitpack.io) takes groupId, artifactId and version id from repository name, -project name and **tag** ignoring actual values from pom.xml. So you need to write: +project name and tag ignoring actual values from pom.xml. So you need to write: ``` @@ -62,5 +62,15 @@ project name and **tag** ignoring actual values from pom.xml. So you need to wri ``` -## Author ## -Samuel Carlsson \ No newline at end of file +## Contributing ## +This project would not be where it is, if it where not for the helpful [contributors](https://github.com/vidstige/jadb/graphs/contributors) +supporting jadb with pull requests, issue reports, and great ideas. If _you_ would like to +contribute, please read through [CONTRIBUTING.md](CONTRIBUTING.md). + +## Authors ## +Samuel Carlsson + +See [contributors](https://github.com/vidstige/jadb/graphs/contributors) for a full list. + +## License ## +This project is released under the Apache License Version 2.0, see [LICENSE.md](LICENSE.md) for more information.