Add basic READMEs

README.md

@@ -44,7 +44,7 @@ An `alias` can be used for the Spring Zero command line tool:
 
 	$ alias spr="java -jar ~/.m2/repository/org/springframework/zero/spring-cli/0.5.0.BUILD-SNAPSHOT/spring-cli-0.5.0.BUILD-SNAPSHOT.jar"
 
-_Also see [CONTRIBUTING.md](/CONTRIBUTING.md) if you want to submit pull requests._  
+_Also see [docs/CONTRIBUTING](docs/CONTRIBUTING.md) if you want to submit pull requests._  
 
 
 ## Quick Start Example
@@ -102,7 +102,7 @@ The 'spring' command line application compiles and runs Groovy source, making it
 easy to write the absolute minimum of code to get an application running. Spring CLI 
 can also watch files, automatically recompiling and restarting when they change.
 
-*See [spring-cli/README.md](spring-cli/README.md).*
+*See [spring-cli/README](spring-cli/README.md).*
 
 
 ### Spring Bootstrap
@@ -115,7 +115,7 @@ Features include:
 * Embedded web applications with a choice of container (Tomcat or Jetty for now)
 * First class externalized configuration support 
 
-_See [spring-bootstrap/README.md](spring-bootstrap/README.md)._
+_See [spring-bootstrap/README](spring-bootstrap/README.md)._
 
   
 ### Spring Autoconfigure
@@ -128,7 +128,7 @@ classpath. For example, If a 'HSQLDB' is on the classpath the user probably want
 in-memory database to be defined. Auto-configuration will back away as the user starts 
 to define their own beans.
 
-_See [spring-autoconfigure/README.md](spring-autoconfigure/README.md)._
+_See [spring-autoconfigure/README](spring-autoconfigure/README.md)._
 
 
 ### Spring Actuator
@@ -138,7 +138,7 @@ writing a JSON web service then it will provide a server, security, logging, ext
 configuration, management endpoints, an audit abstraction, and more. If you want to 
 switch off the built in features, or extend or replace them, it makes that really easy as well.
 
-_See [spring-actuator/README.md](spring-actuator/README.md)._
+_See [spring-actuator/README](spring-actuator/README.md)._
 
 
 ### Spring Starters
@@ -148,7 +148,7 @@ that you need without having to hunt through sample code and copy paste loads of
 dependency descriptors. For example, if you want to get started using Spring and JPA for 
 database access just include one dependency in your project, and you are good to go.
 
-_See [spring-starters/README.md](spring-starters/README.md)._
+_See [spring-starters/README](spring-starters/README.md)._
 
 
 ### Packaging
@@ -157,16 +157,16 @@ The [spring-launcher](spring-launcher/) and
 to package you application for release. Applications can be released as a single jar
 file that can simply be launched using `java -jar`.
 
-_See [spring-launcher/README.md](spring-launcher/README.md) & 
-[spring-package-maven-plugin/README.md](spring-package-maven-plugin/README.md)._
+_See [spring-launcher/README](spring-launcher/README.md) & 
+[spring-package-maven-plugin/README](spring-package-maven-plugin/README.md)._
 
 
 ## Samples
 Groovy samples for use with the command line application are available in
-[spring-cli/samples](spring-cli/samples/). To run the CLI samples type 
+[spring-cli/samples](spring-cli/samples/#). To run the CLI samples type 
 `spr run <sample>.groovy` from samples directory.
 
-Java samples are available in [spring-zero-sample](spring-zero-samples/) and should
+Java samples are available in [spring-zero-sample](spring-zero-samples/#) and should
 be build with maven and run use `java -jar target/<sample>.jar`. The following java
 samples are provided:
 

docs/CONTRIBUTING.md

@@ -62,9 +62,11 @@ Maven is well supported by most Java IDEs. Refer to you vendor documentation.
 
 
 ### Integration tests
-The sample application are used as integration tests during the build. Due to the
-fact that they make use of the `spring-package-maven-plugin` they cannot be called
-directly, and so instead are launched via the `maven-invoker-plugin`. If you encounter
-build failures running the integration tests, check the `build.log` file in the appropriate
-sample directory.
- 
+
+The sample application are used as integration tests during the build
+(when you `mvn install`). Due to the fact that they make use of the
+`spring-package-maven-plugin` they cannot be called directly, and so
+instead are launched via the `maven-invoker-plugin`. If you encounter
+build failures running the integration tests, check the `build.log`
+file in the appropriate sample directory.
+ 

spring-launcher/README.md

@@ -1 +1,5 @@
 # Spring Launcher
+ 
+A very thin Java main for executable JAR and WAR
+archives. `JarLauncher` and `WarLauncher` know how to access classpath
+resources and dependencies in nested jar files.

spring-package-maven-plugin/README.md

@@ -1 +1,22 @@
 # Spring Package Maven Plugin
+
+A maven plugin for building executable JAR and WAR files. To use it
+configure your project to build a JAR or WAR (as appropriate) in the
+normal way, using the `maven-jar-plugin` or `maven-war-plugin`, and
+then add the Spring plugin to your `<build><plugins>` section
+
+`pom.xml`
+```xml
+<plugin>
+    <groupId>org.springframework.zero</groupId>
+    <artifactId>spring-package-maven-plugin</artifactId>
+    <version>{{project.version}}</version>
+    <executions>
+	    <execution>
+            <goals>
+		        <goal>package</goal>
+            </goals>
+        </execution>
+    </executions>
+</plugin>
+```

spring-starters/README.md

@@ -1 +1,4 @@
 # Spring Starters
+
+Aggregated dependencies for starter projects with an opinionated
+choice of Spring and related useful technologies.

spring-starters/pom.xml

@@ -40,7 +40,7 @@
 						<configuration>
 							<useDefaultDelimiters>false</useDefaultDelimiters>
 							<delimiters>
-								<delimiter>#{*}</delimiter>
+								<delimiter>@{*}</delimiter>
 							</delimiters>
 							<resources>
 								<resource>

spring-starters/src/main/parent/pom.xml

@@ -13,7 +13,7 @@
 		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 		<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
 		<spring.version>4.0.0.BUILD-SNAPSHOT</spring.version>
-		<spring.zero.version>#{project.version}</spring.zero.version>
+		<spring.zero.version>@{project.version}</spring.zero.version>
 	</properties>
 	<prerequisites>
 		<maven>3.0</maven>