chore(build): dokka upgrade (#523)

Author: kggilmer

.github/workflows/api-docs.yml

@@ -49,13 +49,16 @@ subprojects {
             }
         }
 
-        val smithyKotlinPackageListUrl: String by project
-        val smithyKotlinDocBaseUrl: String by project
-        // Configure Dokka to link to smithy-kotlin types
-        dokkaSourceSets.configureEach {
-            externalDocumentationLink {
-                packageListUrl.set(URL(smithyKotlinPackageListUrl))
-                url.set(URL(smithyKotlinDocBaseUrl))
+        val smithyKotlinPackageListUrl: String? by project
+        val smithyKotlinDocBaseUrl: String? by project
+        // Configure Dokka to link to smithy-kotlin types if specified in properties
+        // These optional properties are supplied api the api docs build job but are unneeded otherwise
+        if (!smithyKotlinDocBaseUrl.isNullOrEmpty() && !smithyKotlinPackageListUrl.isNullOrEmpty()) {
+            dokkaSourceSets.configureEach {
+                externalDocumentationLink {
+                    packageListUrl.set(URL(smithyKotlinPackageListUrl))
+                    url.set(URL(smithyKotlinDocBaseUrl))
+                }
             }
         }
     }
@@ -89,7 +92,7 @@ if (project.prop("kotlinWarningsAsErrors")?.toString()?.toBoolean() == true) {
 
 // configure the root multimodule docs
 tasks.dokkaHtmlMultiModule.configure {
-    moduleName.set("AWS Kotlin SDK")
+    moduleName.set("AWS SDK for Kotlin")
 
     includes.from(
         // NOTE: these get concatenated
@@ -101,15 +104,6 @@ tasks.dokkaHtmlMultiModule.configure {
         project(":aws-runtime:crt-util"),
     )
     removeChildTasks(excludeFromDocumentation)
-
-    // This allows docs generation to be overridden on the command line.
-    // Used to generate each AWS service individually.
-    if (project.hasProperty("dokkaOutSubDir")) {
-        val subDir = project.prop("dokkaOutSubDir");
-        val targetDir = buildDir.resolve("dokka/$subDir")
-        println("Generating docs in $targetDir")
-        outputDirectory.set(targetDir)
-    }
 }
 
 if (

build.gradle.kts

@@ -16,7 +16,7 @@ smithyKotlinVersion=0.7.8-SNAPSHOT
 
 # kotlin
 kotlinVersion=1.6.10
-dokkaVersion=1.6.0
+dokkaVersion=1.6.10
 
 # kotlin JVM
 kotlinJVMTargetVersion=1.8
@@ -39,7 +39,3 @@ mockkVersion=1.12.0
 
 # logging - JVM
 slf4jVersion=1.7.30
-
-# dokka config (values specified at build-time as needed)
-smithyKotlinPackageListUrl=
-smithyKotlinDocBaseUrl=