Update README.md and add CONTRIBUTING.md

README.md:
--
* Make link to Spring Batch project on spring.io for more context as we already have the git repo
* General Markdown cleanup
* Maven command cleanup
* Fix commercial support link
* Add links to GitHub issues

Added CONTRIBUTING.md from Spring Batch project as a template
--
* CLA project was left as is (SIE doesn't have a specific entry either)
* Removed references to "checkout and building" until thats defined
* Add links to GitHub issues
This commit is contained in:
Chris Schaefer
2014-03-24 10:47:51 -04:00
parent 3215b6f39d
commit 581cb5e6fa
2 changed files with 226 additions and 17 deletions

View File

@@ -1,7 +1,7 @@
Spring Batch Extensions
=============================
The Spring Batch Extensions project provides extension modules for [Spring Batch][]. This project is part of the [Spring organization][] on GitHub.
The Spring Batch Extensions project provides extension modules for the [Spring Batch Project][]. This project is part of the [Spring organization][] on GitHub.
## Available Modules
@@ -25,13 +25,13 @@ on [Stack Overflow][]. [Commercial support][] is available too.
## Issue Tracking
Report issues via the [Spring Batch Extensions Issues][].
Report issues via the Spring Batch Extensions [GitHub Issue Tracker][].
## Building from source
Each module of the *Spring Batch Extensions* project is hosted as independent project with its own release cycle. For the build process of individual modules we recomend using a [Maven][]-based build system modelled after the [Spring Batch][] project.
Each module of the *Spring Batch Extensions* project is hosted as independent project with its own release cycle. For the build process of individual modules we recomend using a [Maven][] build system modelled after the [Spring Batch][] project.
Therefore, the following build instructions should generally apply for most, if not all, *Spring Batch Extensions*. In the instructions below, [`mvn`][] is invoked from the root of the source tree and serves as a cross-platform, self-contained bootstrap mechanism for the build. The only prerequisites are [Git][] and JDK 1.6+.
Therefore, the following build instructions should generally apply for most, if not all, *Spring Batch Extensions*. In the instructions below, `mvn` is invoked from the root of the source tree and serves as a cross-platform, self-contained bootstrap mechanism for the build. The only prerequisites are [Git][] and JDK 1.6+.
### Check out the sources
@@ -39,11 +39,13 @@ Therefore, the following build instructions should generally apply for most, if
### Go into the directory of a specific module
`cd spring-batch-extensions`
`cd module-name`
### Compile and test, build all jars
`mvn package`
`mvn clean package`
### Install the modules jars into your local Maven cache
@@ -53,13 +55,13 @@ Therefore, the following build instructions should generally apply for most, if
### Using Eclipse / STS
When using [SpringSource Tool Suite][] you can directly import Gradle based projects:
When using [Spring Tool Suite] you can directly import Maven based projects:
`File -> Import -> Maven Project`
Alternatively, you can also generate the Eclipse metadata (.classpath and .project files) using Maven:
`mvn eclipse`
`mvn eclipse:eclipse`
Once complete, you may then import the projects into Eclipse as usual:
@@ -69,11 +71,11 @@ Once complete, you may then import the projects into Eclipse as usual:
To generate IDEA metadata (.iml and .ipr files), do the following:
mvn idea
mvn idea:idea
## Contributing
[Pull requests][] are welcome. Please see the [contributor guidelines][] for details. Additionally, if you are contributing, we recommend following the process for Spring Batch as outlined in the [administrator guidelines][].
[Pull requests][] are welcome. Please see the [Contributor Guidelines][] for details.
## Staying in touch
@@ -89,22 +91,19 @@ The Spring Batch Extensions Framework is released under version 2.0 of the [Apac
**We look forward to your contributions!!**
[Spring Batch]: https://github.com/spring-projects/spring-batch
[Spring Batch Project]: http://projects.spring.io/spring-batch/
[Spring organization]: https://github.com/spring-projects
[spring-batch tag]: http://stackoverflow.com/questions/tagged/spring-batch
[Stack Overflow]: http://stackoverflow.com/faq
[Commercial support]: asdf
[Spring Batch Extensions Issues]: https://github.com/mminella/spring-batch-extensions/issues
[the lifecycle of an issue]: https://github.com/cbeams/spring-framework/wiki/The-Lifecycle-of-an-Issue
[Gradle]: http://gradle.org
[`./gradlew`]: http://vimeo.com/34436402
[Commercial support]: https://www.vmware.com/support/services/vfabric-developer.html
[GitHub Issue Tracker]: https://github.com/spring-projects/spring-batch-extensions/issues
[Git]: http://help.github.com/set-up-git-redirect
[Gradle build and release FAQ]: https://github.com/SpringSource/spring-framework/wiki/Gradle-build-and-release-FAQ
[Pull requests]: http://help.github.com/send-pull-requests
[contributor guidelines]: https://github.com/SpringSource/spring-integration/wiki/Contributor-guidelines
[administrator guidelines]: https://github.com/SpringSource/spring-integration/wiki/Administrator-Guidelines
[Spring Batch Admin]: https://github.com/spring-projects/spring-batch-admin
[Spring XD]: https://github.com/spring-projects/spring-xd
[Spring for Apache Hadoop]: https://github.com/spring-projects/spring-hadoop
[Spring Boot]: https://github.com/spring-projects/spring-boot
[Spring Tool Suite]: http://spring.io/tools/sts
[Apache License]: http://www.apache.org/licenses/LICENSE-2.0
[Maven]: http://maven.apache.org
[Contributor Guidelines]: com/spring-projects/spring-batch-extensions/blob/master/CONTRIBUTING.md