Merge pull request #308 from OneBusAway/release-please--branches--main--changes--next

release: 0.1.0-alpha.67

Author: Ahmedhossamdev

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.66"
+  ".": "0.1.0-alpha.67"
 }

CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.1.0-alpha.67 (2025-05-15)
+
+Full Changelog: [v0.1.0-alpha.66...v0.1.0-alpha.67](https://github.com/OneBusAway/kotlin-sdk/compare/v0.1.0-alpha.66...v0.1.0-alpha.67)
+
+### Features
+
+* generate and publish docs ([#274](https://github.com/OneBusAway/kotlin-sdk/issues/274)) ([4aecdbd](https://github.com/OneBusAway/kotlin-sdk/commit/4aecdbdb54266d24cae48500180c6e1903712645))
+
+
+### Chores
+
+* **internal:** update java toolchain ([ed72b2f](https://github.com/OneBusAway/kotlin-sdk/commit/ed72b2f4944d7ce9ce611d7e0b1830f8761f55bf))
+
 ## 0.1.0-alpha.66 (2025-03-07)
 
 Full Changelog: [v0.1.0-alpha.65...v0.1.0-alpha.66](https://github.com/OneBusAway/kotlin-sdk/compare/v0.1.0-alpha.65...v0.1.0-alpha.66)

README.md

@@ -2,7 +2,8 @@
 
 <!-- x-release-please-start-version -->
 
-[![Maven Central](https://img.shields.io/maven-central/v/org.onebusaway/onebusaway-sdk-kotlin)](https://central.sonatype.com/artifact/org.onebusaway/onebusaway-sdk-kotlin/0.1.0-alpha.66)
+[![Maven Central](https://img.shields.io/maven-central/v/org.onebusaway/onebusaway-sdk-kotlin)](https://central.sonatype.com/artifact/org.onebusaway/onebusaway-sdk-kotlin/0.1.0-alpha.67)
+[![javadoc](https://javadoc.io/badge2/org.onebusaway/onebusaway-sdk-kotlin/0.1.0-alpha.67/javadoc.svg)](https://javadoc.io/doc/org.onebusaway/onebusaway-sdk-kotlin/0.1.0-alpha.67)
 
 <!-- x-release-please-end -->
 
@@ -12,7 +13,7 @@ The Onebusaway SDK Kotlin SDK is similar to the Onebusaway SDK Java SDK but with
 
 It is generated with [Stainless](https://www.stainless.com/).
 
-The REST API documentation can be found on [developer.onebusaway.org](https://developer.onebusaway.org).
+The REST API documentation can be found on [developer.onebusaway.org](https://developer.onebusaway.org). KDocs are also available on [javadoc.io](https://javadoc.io/doc/org.onebusaway/onebusaway-sdk-kotlin/0.1.0-alpha.65).
 
 ## Installation
 
@@ -21,7 +22,7 @@ The REST API documentation can be found on [developer.onebusaway.org](https://de
 ### Gradle
 
 ```kotlin
-implementation("org.onebusaway:onebusaway-sdk-kotlin:0.1.0-alpha.66")
+implementation("org.onebusaway:onebusaway-sdk-kotlin:0.1.0-alpha.67")
 ```
 
 ### Maven
@@ -30,7 +31,7 @@ implementation("org.onebusaway:onebusaway-sdk-kotlin:0.1.0-alpha.66")
 <dependency>
     <groupId>org.onebusaway</groupId>
     <artifactId>onebusaway-sdk-kotlin</artifactId>
-    <version>0.1.0-alpha.66</version>
+    <version>0.1.0-alpha.67</version>
 </dependency>
 ```
 

build.gradle.kts

@@ -1,8 +1,23 @@
 plugins {
-    id("io.github.gradle-nexus.publish-plugin") version "1.1.0"
+    id("org.jetbrains.dokka") version "2.0.0"
+}
+
+repositories {
+    mavenCentral()
 }
 
 allprojects {
     group = "org.onebusaway"
-    version = "0.1.0-alpha.66" // x-release-please-version
+    version = "0.1.0-alpha.67" // x-release-please-version
+}
+
+subprojects {
+    apply(plugin = "org.jetbrains.dokka")
+}
+
+// Avoid race conditions between `dokkaHtmlCollector` and `dokkaJavadocJar` tasks
+tasks.named("dokkaHtmlCollector").configure {
+    subprojects.flatMap { it.tasks }
+        .filter { it.project.name != "onebusaway-sdk-kotlin" && it.name == "dokkaJavadocJar" }
+        .forEach { mustRunAfter(it) }
 }

buildSrc/src/main/kotlin/onebusaway-sdk.java.gradle.kts

@@ -21,7 +21,7 @@ configure<SpotlessExtension> {
 
 java {
     toolchain {
-        languageVersion.set(JavaLanguageVersion.of(17))
+        languageVersion.set(JavaLanguageVersion.of(21))
     }
 }
 

buildSrc/src/main/kotlin/onebusaway-sdk.publish.gradle.kts

@@ -1,3 +1,5 @@
+import com.vanniktech.maven.publish.JavadocJar
+import com.vanniktech.maven.publish.KotlinJvm
 import com.vanniktech.maven.publish.MavenPublishBaseExtension
 import com.vanniktech.maven.publish.SonatypeHost
 
@@ -19,6 +21,12 @@ configure<MavenPublishBaseExtension> {
     publishToMavenCentral(SonatypeHost.CENTRAL_PORTAL)
 
     coordinates(project.group.toString(), project.name, project.version.toString())
+    configure(
+        KotlinJvm(
+            javadocJar = JavadocJar.Dokka("dokkaHtml"),
+            sourcesJar = true,
+        )
+    )
 
     pom {
         name.set("OneBusAway")

onebusaway-sdk-kotlin/build.gradle.kts

@@ -6,3 +6,24 @@ plugins {
 dependencies {
     api(project(":onebusaway-sdk-kotlin-client-okhttp"))
 }
+
+// Redefine `dokkaHtml` to:
+// - Depend on the root project's task for merging the docs of all the projects
+// - Forward that task's output to this task's output
+tasks.named("dokkaHtml").configure {
+    actions.clear()
+
+    val dokkaHtmlCollector = rootProject.tasks["dokkaHtmlCollector"]
+    dependsOn(dokkaHtmlCollector)
+
+    val outputDirectory = project.layout.buildDirectory.dir("dokka/html")
+    doLast {
+        copy {
+            from(dokkaHtmlCollector.outputs.files)
+            into(outputDirectory)
+            duplicatesStrategy = DuplicatesStrategy.INCLUDE
+        }
+    }
+
+    outputs.dir(outputDirectory)
+}