From 9ea1f845a893ea84853961eeb63188e67e686676 Mon Sep 17 00:00:00 2001
From: Jesse Wilson <jwilson@squareup.com>
Date: Tue, 14 Aug 2018 20:20:15 -0400
Subject: [PATCH] Generate Kotlin documentation with Dokka

---
 kotlin/codegen/pom.xml                | 35 ++++++++++++++++++++++++++
 kotlin/codegen/src/assembly/dokka.xml | 16 ++++++++++++
 kotlin/reflect/pom.xml                | 35 ++++++++++++++++++++++++++
 kotlin/reflect/src/assembly/dokka.xml | 16 ++++++++++++
 kotlin/tests/pom.xml                  | 36 +++++++++++++++++++++++++++
 kotlin/tests/src/assembly/dokka.xml   | 16 ++++++++++++
 pom.xml                               | 10 ++++++++
 7 files changed, 164 insertions(+)
 create mode 100644 kotlin/codegen/src/assembly/dokka.xml
 create mode 100644 kotlin/reflect/src/assembly/dokka.xml
 create mode 100644 kotlin/tests/src/assembly/dokka.xml

diff --git a/kotlin/codegen/pom.xml b/kotlin/codegen/pom.xml
index 64a4a07..37d2873 100644
--- a/kotlin/codegen/pom.xml
+++ b/kotlin/codegen/pom.xml
@@ -77,6 +77,10 @@
     </dependency>
   </dependencies>
 
+  <properties>
+    <maven.javadoc.skip>true</maven.javadoc.skip><!-- We use Dokka instead. -->
+  </properties>
+
   <build>
     <plugins>
       <plugin>
@@ -181,6 +185,37 @@
           </execution>
         </executions>
       </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-assembly-plugin</artifactId>
+        <version>${maven-assembly.version}</version>
+        <executions>
+          <execution>
+            <phase>package</phase>
+            <goals>
+              <goal>single</goal>
+            </goals>
+          </execution>
+        </executions>
+        <configuration>
+          <descriptors>
+            <descriptor>src/assembly/dokka.xml</descriptor>
+          </descriptors>
+        </configuration>
+      </plugin>
+      <plugin>
+        <groupId>org.jetbrains.dokka</groupId>
+        <artifactId>dokka-maven-plugin</artifactId>
+        <version>${dokka.version}</version>
+        <executions>
+          <execution>
+            <phase>prepare-package</phase>
+            <goals>
+              <goal>dokka</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
     </plugins>
   </build>
 </project>
diff --git a/kotlin/codegen/src/assembly/dokka.xml b/kotlin/codegen/src/assembly/dokka.xml
new file mode 100644
index 0000000..b763232
--- /dev/null
+++ b/kotlin/codegen/src/assembly/dokka.xml
@@ -0,0 +1,16 @@
+<assembly
+    xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 http://maven.apache.org/xsd/assembly-1.1.3.xsd">
+  <id>javadoc</id>
+  <formats>
+    <format>jar</format>
+  </formats>
+  <baseDirectory>/</baseDirectory>
+  <fileSets>
+    <fileSet>
+      <directory>target/dokka/moshi-kotlin-codegen</directory>
+      <outputDirectory>/</outputDirectory>
+    </fileSet>
+  </fileSets>
+</assembly>
diff --git a/kotlin/reflect/pom.xml b/kotlin/reflect/pom.xml
index b672a91..fa924cb 100644
--- a/kotlin/reflect/pom.xml
+++ b/kotlin/reflect/pom.xml
@@ -43,6 +43,10 @@
     </dependency>
   </dependencies>
 
+  <properties>
+    <maven.javadoc.skip>true</maven.javadoc.skip><!-- We use Dokka instead. -->
+  </properties>
+
   <build>
     <plugins>
       <plugin>
@@ -97,6 +101,37 @@
           </archive>
         </configuration>
       </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-assembly-plugin</artifactId>
+        <version>${maven-assembly.version}</version>
+        <executions>
+          <execution>
+            <phase>package</phase>
+            <goals>
+              <goal>single</goal>
+            </goals>
+          </execution>
+        </executions>
+        <configuration>
+          <descriptors>
+            <descriptor>src/assembly/dokka.xml</descriptor>
+          </descriptors>
+        </configuration>
+      </plugin>
+      <plugin>
+        <groupId>org.jetbrains.dokka</groupId>
+        <artifactId>dokka-maven-plugin</artifactId>
+        <version>${dokka.version}</version>
+        <executions>
+          <execution>
+            <phase>prepare-package</phase>
+            <goals>
+              <goal>dokka</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
     </plugins>
   </build>
 </project>
diff --git a/kotlin/reflect/src/assembly/dokka.xml b/kotlin/reflect/src/assembly/dokka.xml
new file mode 100644
index 0000000..1ca7f3c
--- /dev/null
+++ b/kotlin/reflect/src/assembly/dokka.xml
@@ -0,0 +1,16 @@
+<assembly
+    xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 http://maven.apache.org/xsd/assembly-1.1.3.xsd">
+  <id>javadoc</id>
+  <formats>
+    <format>jar</format>
+  </formats>
+  <baseDirectory>/</baseDirectory>
+  <fileSets>
+    <fileSet>
+      <directory>target/dokka/moshi-kotlin</directory>
+      <outputDirectory>/</outputDirectory>
+    </fileSet>
+  </fileSets>
+</assembly>
diff --git a/kotlin/tests/pom.xml b/kotlin/tests/pom.xml
index a50021d..4c9c541 100644
--- a/kotlin/tests/pom.xml
+++ b/kotlin/tests/pom.xml
@@ -38,6 +38,11 @@
       <scope>test</scope>
     </dependency>
   </dependencies>
+
+  <properties>
+    <maven.javadoc.skip>true</maven.javadoc.skip><!-- We use Dokka instead. -->
+  </properties>
+
   <build>
     <plugins>
       <plugin>
@@ -143,6 +148,37 @@
           </execution>
         </executions>
       </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-assembly-plugin</artifactId>
+        <version>${maven-assembly.version}</version>
+        <executions>
+          <execution>
+            <phase>package</phase>
+            <goals>
+              <goal>single</goal>
+            </goals>
+          </execution>
+        </executions>
+        <configuration>
+          <descriptors>
+            <descriptor>src/assembly/dokka.xml</descriptor>
+          </descriptors>
+        </configuration>
+      </plugin>
+      <plugin>
+        <groupId>org.jetbrains.dokka</groupId>
+        <artifactId>dokka-maven-plugin</artifactId>
+        <version>${dokka.version}</version>
+        <executions>
+          <execution>
+            <phase>prepare-package</phase>
+            <goals>
+              <goal>dokka</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
     </plugins>
   </build>
 </project>
diff --git a/kotlin/tests/src/assembly/dokka.xml b/kotlin/tests/src/assembly/dokka.xml
new file mode 100644
index 0000000..d34d1dd
--- /dev/null
+++ b/kotlin/tests/src/assembly/dokka.xml
@@ -0,0 +1,16 @@
+<assembly
+    xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.3 http://maven.apache.org/xsd/assembly-1.1.3.xsd">
+  <id>javadoc</id>
+  <formats>
+    <format>jar</format>
+  </formats>
+  <baseDirectory>/</baseDirectory>
+  <fileSets>
+    <fileSet>
+      <directory>target/dokka/moshi-kotlin-tests</directory>
+      <outputDirectory>/</outputDirectory>
+    </fileSet>
+  </fileSets>
+</assembly>
diff --git a/pom.xml b/pom.xml
index d17780c..67408d5 100644
--- a/pom.xml
+++ b/pom.xml
@@ -31,6 +31,8 @@
     <java.version>1.7</java.version>
     <kotlin.version>1.2.21</kotlin.version>
     <kotlin-metadata.version>1.3.0</kotlin-metadata.version>
+    <dokka.version>0.9.17</dokka.version>
+    <maven-assembly.version>3.1.0</maven-assembly.version>
 
     <!-- Dependencies -->
     <okio.version>1.14.0</okio.version>
@@ -122,6 +124,14 @@
     </dependencies>
   </dependencyManagement>
 
+  <pluginRepositories>
+    <pluginRepository>
+      <id>jcenter</id>
+      <name>JCenter</name>
+      <url>https://jcenter.bintray.com/</url>
+    </pluginRepository>
+  </pluginRepositories>
+
   <build>
     <pluginManagement>
       <plugins>