Clean up parent poms and clarify building and deploying

To deploy to snapshot repos you need

-DaltSnapshotDeploymentRepository=\
repo.spring.io::default::https://repo.spring.io/libs-snapshot-local

(as per /travis.yml) because the parent for spring-cloud-starter-parent
does not have a repository declared.

.travis.yml

@@ -13,7 +13,7 @@ install:
 - mvn --settings .settings.xml install -P docs -q -U -DskipTests=true -Dmaven.test.redirectTestOutputToFile=true
 - ./docs/src/main/asciidoc/ghpages.sh
 script:
-- '[ "${TRAVIS_PULL_REQUEST}" != "false" ] || mvn --settings .settings.xml deploy -P release -nsu -Dmaven.test.redirectTestOutputToFile=true'
+- '[ "${TRAVIS_PULL_REQUEST}" != "false" ] || mvn --settings .settings.xml deploy -DaltSnapshotDeploymentRepository=repo.spring.io::default::https://repo.spring.io/libs-snapshot-local -P release -nsu -Dmaven.test.redirectTestOutputToFile=true'
 - '[ "${TRAVIS_PULL_REQUEST}" = "false" ] || mvn --settings .settings.xml install -nsu -Dmaven.test.redirectTestOutputToFile=true'
 env:
   global:

README.adoc

@@ -2,16 +2,7 @@
 
 Spring Cloud Starters are curated sets of dependencies focused on a particular type of workload. Including a starter on your classpath is really just a shorthand for including its dependencies, but it makes it easier to organize your code and easier to remember what the depdnencies are for. (See also http://github.com/spring-projects/spring-boot/tree/master/spring-boot-starters[Spring Boot starter projects].) Starters provided include:
 
-* spring-cloud-starter
-* spring-cloud-starter-bus-amqp
-* spring-cloud-starter-cloudfoundry
-* spring-cloud-starter-eureka
-* spring-cloud-starter-eureka-server
-* spring-cloud-starter-hystrix
-* spring-cloud-starter-hystrix-dashboard
-* spring-cloud-starter-turbine
-* spring-cloud-starter-zuul
-
 == Contributing
 
-link:https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/docs/src/main/asciidoc/contributing.adoc[]
+link:https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/docs/src/main/asciidoc/contributing.adoc[]
+

docs/src/main/asciidoc/README.adoc

@@ -4,4 +4,32 @@ include::intro.adoc[]
 
 include::https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/docs/src/main/asciidoc/contributing.adoc[]
 
+== Building and Deploying
+
+Since there is no code to compile in the starters they should do not need to compile, but a compiler has to be available because they are built and deployed as JAR artifacts. To install locally:
+
+----
+
+$ mvn install
+----
+
+and to deploy snapshots to repo.spring.io:
+
+----
+$ mvn install -DaltSnapshotDeploymentRepository=repo.spring.io::default::https://repo.spring.io/libs-snapshot-local
+----
+
+for a RELEASE build use
+
+----
+$ mvn install -DaltReleaseDeploymentRepository=repo.spring.io::default::https://repo.spring.io/libs-release-local
+----
+
+and for Maven Central use
+
+----
+$ mvn install -P central -DaltReleaseDeploymentRepository=sonatype-nexus-staging::default::https://oss.sonatype.org/service/local/staging/deploy/maven2
+----
+
+(the "central" profile is available for all projects in Spring Cloud and it sets up the gpg jar signing, and the repository has to be specified separately for this project because it is a parent of the starter parent which users in turn have as their own parent).
 

pom.xml

@@ -7,7 +7,7 @@
 	<description>Spring Cloud Starter Build</description>
 	<parent>
 		<groupId>org.springframework.cloud</groupId>
-		<artifactId>spring-cloud-parent</artifactId>
+		<artifactId>spring-cloud-build</artifactId>
 		<version>1.0.0.BUILD-SNAPSHOT</version>
 		<relativePath/>
 	</parent>