chore(build): Auto-generate plugin api docs

.github/workflows/docs_master.yml

@@ -0,0 +1,39 @@
+name: Generate and Publish Docs
+
+on:
+  push:
+    branches:
+      - master
+
+env:
+  GRADLE_OPTS: -Dorg.gradle.daemon=false
+
+jobs:
+  generate-docs:
+    # Only run the root repository
+    if: startsWith(github.repository, 'spinnaker/')
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-java@v1
+        with:
+          java-version: 11
+      - uses: actions/cache@v1
+        with:
+          path: ~/.gradle
+          key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }}
+          restore-keys: |
+            ${{ runner.os }}-gradle-
+      - name: Docs
+        run: ./gradlew dokkaHtml --stacktrace
+      - name: Publish orca-api docs
+        uses: spinnaker/ghaction-copy-to-repository@main
+        env:
+          API_TOKEN_GITHUB: ${{ secrets.SPINNAKER_GITHUB_TOKEN }}
+        with:
+          source-directory: orca-api/build/dokka/html/
+          destination-github-username: spinnaker
+          destination-repository-name: spinnaker.github.io
+          destination-directory: reference/api/service-plugin-apis/orca-api/master/x
+          user-email: sig-docs@spinnaker.io
+          user-name: autodocs

build.gradle

@@ -18,8 +18,8 @@ plugins {
   id 'io.spinnaker.project' version "$spinnakerGradleVersion" apply false
   id "nebula.kotlin" version "$kotlinVersion" apply false
   id "org.jetbrains.kotlin.plugin.allopen" version "$kotlinVersion" apply false
-  id "org.jetbrains.dokka" version "0.10.1" apply false
   id "io.gitlab.arturbosch.detekt" version "1.7.4" apply false
+  id "org.jetbrains.dokka" version "1.4.10" apply false
 }
 
 allprojects {

gradle/dokka.gradle

@@ -16,11 +16,10 @@
 
 apply plugin: "org.jetbrains.dokka"
 
-dokka {
-  outputFormat = 'html'
-  outputDirectory = "$buildDir/dokka"
-
-  configuration {
-    jdkVersion = 8
+dokkaHtml {
+  dokkaSourceSets {
+    configureEach {
+      jdkVersion.set(11)
+    }
   }
 }

orca-api/orca-api.gradle

@@ -44,6 +44,8 @@ dependencies {
   testRuntimeOnly("org.junit.jupiter:junit-jupiter-api")
   testRuntimeOnly("org.junit.vintage:junit-vintage-engine")
 
+  dokkaHtmlPlugin("org.jetbrains.dokka:kotlin-as-java-plugin:1.4.10")
+
   sampleImplementation(sourceSets.main.runtimeClasspath)
 }
 
@@ -60,9 +62,3 @@ test {
     includeEngines "junit-vintage", "junit-jupiter"
   }
 }
-
-dokka {
-  configuration {
-    includes = ["api.md"]
-  }
-}

settings.gradle

@@ -13,6 +13,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+pluginManagement {
+  repositories {
+    gradlePluginPortal()
+    jcenter()
+  }
+}
 
 ['fiat', 'kork'].each { prj ->
   String propName = "${prj}Composite"