Refine doc

Author: cuzfrog

doc/Development.md

@@ -16,7 +16,8 @@ Internal types also have javadoc for more information.
 * `e2e` contains e2e json 2-way serialization and deserialization tests against target languages' http servers.
 * `build-tool-plugins` contains Maven and Gradle plugin for SharedType annotation.
     * `exec` contains generic annotation processor executor.
-    * `maven-plugin/it` contains integration tests for maven plugin.
+    * `maven-plugin` and `maven-plugin/it` contains Maven plugin and integration tests.
+    * `gradle-plugin` and `gradle-plugin/it` contains Gradle plugin and integration tests.
 
 Domain types are shared among processor and integration tests to reduce maven module count.
 
@@ -33,14 +34,15 @@ Optionally mount tmpfs to save your disk by:
 ```
 Optionally setup `MVND_HOME` to use [maven daemon](https://github.com/apache/maven-mvnd) by `mvnd`
 
-Choose maven profiles in IDE accordingly as below.
+**Choose maven profiles in IDE accordingly as below.**
 
 ### Maven profiles
 * `dev` and `release` - control whether to include test maven modules during build.
 * `it` - enable integration test profile. `internal` folder is shared source between `processor` and `it`,
 IDE may not able to properly resolve classes in `internal` folder for both modules.
 Enable this profile to enable `it` modules in IDE, and disable it when developing against `processor` module.
 * `it-no-jpms` and `it-jpms` - control whether to enable Java 9 Jigsaw module test in `it`. `it/java8` sources are reused to test on jdk9. Turn on `it-jpms` for IDE to correctly resolve `it/java8` classes.
+* `java8-jdk-tools-jar` - auto managed for adding `tools.jar` dependency for annotation processor.
 * `dev-build-tool` - controls build tool plugin modules.
 
 ## Development

doc/Usage.md

@@ -41,13 +41,19 @@ The advantage of using `sharedtype-maven-plugin` is that no need to execute othe
 
 ### Gradle
 Add sharedtype plugin and annotation dependency:
+```properties
+# gradle.properties
+sharedtypeVersion=<your-version>
+```
+
 ```groovy
+// build.gradle
 plugins {
-    id("online.sharedtype.sharedtype-gradle-plugin") version "${sharedtype.version}"
+    id "online.sharedtype.sharedtype-gradle-plugin" version "${sharedtypeVersion}"
 }
 
 dependencies {
-    compileOnly "online.sharedtype:sharedtype:${sharedtype.version}"
+    compileOnly "online.sharedtype:sharedtype:${sharedtypeVersion}"
 }
 ```