From 3921232cfbb54516375be13fdda1468627b44758 Mon Sep 17 00:00:00 2001
From: Leonard Ehrenfried <mail@leonard.io>
Date: Wed, 13 Sep 2023 11:05:43 +0200
Subject: [PATCH] Remove enunciate REST API documentation generator

---
 docs/ReleaseChecklist.md | 12 ------------
 enunciate.xml            | 29 -----------------------------
 pom.xml                  | 24 ------------------------
 3 files changed, 65 deletions(-)
 delete mode 100644 enunciate.xml

diff --git a/docs/ReleaseChecklist.md b/docs/ReleaseChecklist.md
index 372222d104f..5215b6c8457 100644
--- a/docs/ReleaseChecklist.md
+++ b/docs/ReleaseChecklist.md
@@ -48,18 +48,6 @@ manually is more tedious, but keeps eyes on each step and is less prone to failu
     * You can also use the `package` goal instead of the `install` goal to avoid signing if you
       don't have the GPG certificate installed.
     * All tests should pass
-    * Run `MAVEN_OPTS="--add-exports jdk.compiler/com.sun.tools.javac.api=ALL-UNNAMED --add-exports jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED" mvn com.webcohesion.enunciate:enunciate-maven-plugin:docs`
-    * This build will also create Enunciate API docs and Javadoc with the correct non-snapshot
-      version number
-* Deploy the documentation to AWS S3
-    * You have to do this right after the test release build to ensure the right version number in
-      the docs
-    * You will need AWSCLI tools (`sudo pip install -U awscli`)
-    * You will need AWS credentials with write access to the bucket `s3://dev.opentripplanner.org`
-    * `aws s3 cp --recursive target/site/apidocs s3://dev.opentripplanner.org/javadoc/x.y.z --acl public-read`
-    * `aws s3 cp --recursive target/site/enunciate/apidocs s3://dev.opentripplanner.org/apidoc/x.y.z --acl public-read`
-    * Check that docs are readable and show the correct version via
-      the [development documentation landing page](http://dev.opentripplanner.org).
 * Finally, if everything looks good, tag and push this release to make it official
     * `git tag -a vX.Y.Z -m "release X.Y.Z"`
     * `git push origin vX.Y.Z`
diff --git a/enunciate.xml b/enunciate.xml
deleted file mode 100644
index 5b5a0cbfaeb..00000000000
--- a/enunciate.xml
+++ /dev/null
@@ -1,29 +0,0 @@
-<enunciate xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-           xsi:noNamespaceSchemaLocation="http://enunciate.webcohesion.com/schemas/enunciate-2.4.0.xsd">
-
-  <!--
-  We only use Enunciate to generate documentation for the trip planner API.
-  This is a barebones config file that moslty just turns off modules we don't need.
-  See https://github.com/stoicflame/enunciate/wiki/User-Guide#configuration
-  -->
-
-  <modules>
-    <c-xml-client disabled="true"/>
-    <csharp-xml-client disabled="true"/>
-    <java-xml-client disabled="true"/>
-    <java-json-client disabled="true"/>
-    <gwt-json-overlay disabled="true"/>
-    <obj-c-xml-client disabled="true"/>
-    <php-xml-client disabled="true"/>
-    <php-json-client disabled="true"/>
-    <ruby-json-client disabled="true"/>
-    <idl disabled="true"/>
-    <swagger disabled="true"/>
-    <docs disableRestMountpoint="true"  includeApplicationPath="true"/>
-    <jaxrs>
-       <application path="/otp/" />
-    </jaxrs>
-    <jackson1 disabled="true"/>
-  </modules>
-
-</enunciate>
diff --git a/pom.xml b/pom.xml
index bef2c8b5fb4..c9ed7e7d10c 100644
--- a/pom.xml
+++ b/pom.xml
@@ -182,23 +182,6 @@
                     </execution>
                 </executions>
             </plugin>
-            <plugin>
-                <groupId>com.webcohesion.enunciate</groupId>
-                <artifactId>enunciate-maven-plugin</artifactId>
-                <version>2.15.1</version>
-                <executions>
-                    <execution>
-                        <!-- override default binding to process-sources phase (enunciate generates web services). -->
-                        <phase>site</phase>
-                        <goals>
-                            <goal>docs</goal>
-                        </goals>
-                    </execution>
-                </executions>
-                <configuration>
-                    <docsDir>${project.build.directory}/site/enunciate</docsDir>
-                </configuration>
-            </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-source-plugin</artifactId>
@@ -256,13 +239,6 @@
                     </execution>
                 </executions>
             </plugin>
-
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-site-plugin</artifactId>
-                <version>3.12.1</version>
-            </plugin>
-
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-surefire-plugin</artifactId>