From 5881a3df60336517bb78882c9b1c7a79de3f7a10 Mon Sep 17 00:00:00 2001
From: Marc Schlegel <marc.schlegel@gmx.de>
Date: Mon, 19 Jan 2026 16:45:58 +0100
Subject: [PATCH 1/2] Add doc goal for scala-maven-plugin

---
 modules/openapi-generator-mill-plugin/pom.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/modules/openapi-generator-mill-plugin/pom.xml b/modules/openapi-generator-mill-plugin/pom.xml
index d339710eaaa8..cb6875eae066 100644
--- a/modules/openapi-generator-mill-plugin/pom.xml
+++ b/modules/openapi-generator-mill-plugin/pom.xml
@@ -137,6 +137,7 @@
                         <goals>
                             <goal>compile</goal>
                             <goal>testCompile</goal>
+                            <goal>doc-jar</goal>
                         </goals>
                     </execution>
                 </executions>

From 3eb82c14e17150d99f55770e50ae87d2658999f1 Mon Sep 17 00:00:00 2001
From: Marc Schlegel <marc.schlegel@gmx.de>
Date: Mon, 19 Jan 2026 18:00:15 +0100
Subject: [PATCH 2/2] Add workaround for scaladoc generation in Scala 3

---
 modules/openapi-generator-mill-plugin/pom.xml | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/modules/openapi-generator-mill-plugin/pom.xml b/modules/openapi-generator-mill-plugin/pom.xml
index cb6875eae066..c98258ef569f 100644
--- a/modules/openapi-generator-mill-plugin/pom.xml
+++ b/modules/openapi-generator-mill-plugin/pom.xml
@@ -137,8 +137,29 @@
                         <goals>
                             <goal>compile</goal>
                             <goal>testCompile</goal>
+                        </goals>
+                    </execution>
+                    <execution>
+                        <!-- see https://github.com/davidB/scala-maven-plugin/issues/604 why a workaround is needed -->
+                        <id>attach-javadocs</id>
+                        <goals>
                             <goal>doc-jar</goal>
                         </goals>
+                        <configuration>
+                            <scaladocClassName>dotty.tools.scaladoc.Main</scaladocClassName>
+                            <sourceDir>${project.build.outputDirectory}</sourceDir>
+                            <args>-nobootcp</args>
+                            <includes>
+                                <include>**/*.tasty</include>
+                            </includes>
+                            <dependencies>
+                                <dependency>
+                                    <groupId>org.scala-lang</groupId>
+                                    <artifactId>scaladoc_3</artifactId>
+                                    <version>3.7.4</version>
+                                </dependency>
+                            </dependencies>
+                        </configuration>
                     </execution>
                 </executions>
             </plugin>