Reorganized docs to be a tad more hierarchical. Show the basics first, and give links to the more detailed stuff later.

Author: travis-ci

README.md

@@ -36,15 +36,7 @@ When you run `gradlew ide`, it builds and downloads an IDE into `build/oomphIde`
 apply plugin: 'com.diffplug.gradle.oomph.ide'
 oomphIde {
 	repoEclipseLatest()
-	jdt {
-		//Some *optional* older (or newer) JRE/JDK
-		installedJre({ jre ->
-			jre.version = '1.6.0_45'
-			jre.installedLocation = new File('C:/jdk1.6.0_45')
-			jre.markDefault = true // or false
-			jre.executionEnvironments = ['JavaSE-1.6'] //any or as many execution environments can be specified here.
-		})
-	}
+	jdt {}
 	eclipseIni {
 		vmargs('-Xmx2g')    // IDE can have up to 2 gigs of RAM
 	}
@@ -55,14 +47,7 @@ oomphIde {
 }
 ```
 
-See the [plugin's javadoc](https://diffplug.github.io/goomph/javadoc/3.4.0/com/diffplug/gradle/oomph/OomphIdePlugin.html) for more details.
-
-Examples (submit a PR with yours here!)
-
-- [Gradle and Eclipse RCP talk](https://github.com/diffplug/gradle_and_eclipse_rcp/blob/master/ide/build.gradle) (multi-project Eclipse RCP project)
-- [ls-api](https://github.com/TypeFox/ls-api/blob/61a3089569acbe159f043534f282401452a34bc3/ide/build.gradle) (xtend IDE example)
-- [Spotless](https://github.com/diffplug/spotless/blob/master/build.gradle) (single-project Gradle plugin)
-- (your example here)
+See the [plugin's javadoc](https://diffplug.github.io/goomph/javadoc/3.4.0/com/diffplug/gradle/oomph/OomphIdePlugin.html) for a quickstart, and [HOW_TO_AUTOMATE_IDE.md](HOW_TO_AUTOMATE_IDE.md) for examples and more in-depth details.
 
 ## Blog posts
 

src/main/java/com/diffplug/gradle/oomph/ConventionJdt.java

@@ -20,6 +20,29 @@
 
 import org.gradle.api.Action;
 
+/**
+ * Adding the JDT convention to your project
+ * adds the following features:
+ * 
+ * - `org.eclipse.platform.ide`
+ * - `org.eclipse.jdt`
+ * - `org.eclipse.ui.views.log`
+ * 
+ * You can set the installed JRE as follows:
+ * 
+ * ```gradle
+ * oomphIde {
+ *     jdt {
+ *         installedJre {
+ *             version = '1.6.0_45'
+ *             installedLocation = new File('C:/jdk1.6.0_45')
+ *             markDefault = true // or false
+ *             executionEnvironments = ['JavaSE-1.6'] // any execution environments can be specified here.
+ *         }
+ *     }
+ * }
+ * ```
+ */
 public class ConventionJdt extends OomphConvention {
 	ConventionJdt(OomphIdeExtension extension) {
 		super(extension);

src/main/java/com/diffplug/gradle/oomph/ConventionPde.java

@@ -23,6 +23,27 @@
 
 import com.diffplug.gradle.OrderingConstraints;
 
+/**
+ * Adding the PDE convention to your project
+ * adds the following features:
+ * 
+ * - `org.eclipse.platform.ide`
+ * - `org.eclipse.jdt`
+ * - `org.eclipse.pde`
+ * 
+ * You can set the targetplatform as follows:
+ * 
+ * ```gradle
+ * oomphIde {
+ *     pde {
+ *         targetplatform {
+ *             it.installation '../target.maven/build'
+ *             it.installation '../target.p2/build/p2asmaven/p2runnable/eclipse-deps'
+ *         }
+ *     }
+ * }
+ * ```
+ */
 public class ConventionPde extends OomphConvention {
 	ConventionPde(OomphIdeExtension extension) {
 		super(extension);

src/main/java/com/diffplug/gradle/oomph/OomphIdePlugin.java

@@ -31,7 +31,7 @@
  *
  * - `gradlew ide` launches the IDE, after running any required setup tasks.
  *
- * To create an IDE for java projects:
+ * To create an IDE for java projects (see {@link ConventionJdt} for more JDT options).
  *
  * ```groovy
  * apply plugin: 'com.diffplug.gradle.oomph.ide'
@@ -41,17 +41,12 @@
  * }
  * ```
  *
- * For an Eclipse Plugin project with a target platform:
+ * For an Eclipse Plugin project (see {@link ConventionPde} for more JDT options).
  * 
  * ```groovy
  * oomphIde {
  *     repoEclipse '4.5.2'
- *     pde {
- *         targetplatform {
- *             installation 'target.maven/build'
- *             installation 'target.p2/build/p2asmaven/p2'
- *         }
- *     }
+ *     pde {}
  * }
  * ```
  *