From 8f5a6efd42dd7762159e9dc884cbbc2824377e55 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jonah=20Br=C3=BCchert?= <jbb@kaidan.im>
Date: Thu, 19 Dec 2024 14:25:09 +0100
Subject: [PATCH] Update API documentation for MOTIS 2

---
 website/content/_index.html                  |  6 +----
 website/content/api.html                     | 24 ++++++++++++++++++++
 website/layouts/shortcodes/source-table.html | 10 --------
 website/static/custom.css                    |  8 +++++++
 4 files changed, 33 insertions(+), 15 deletions(-)
 create mode 100644 website/content/api.html

diff --git a/website/content/_index.html b/website/content/_index.html
index a49977d0..7632c7a5 100644
--- a/website/content/_index.html
+++ b/website/content/_index.html
@@ -13,10 +13,6 @@
 -->
 
 <style>
-h2 {
-  margin-top: 50px;
-}
-
 .app-icon {
   margin: 10px;
 }
@@ -39,7 +35,7 @@ <h2>Apps That Use Transitous</h2>
 
 <h2>Use In Your App</h2>
 <p>Transitous provides a free to use API that can provide journey planning in your app.</p>
-<a class="btn btn-primary text-black" href="https://routing.spline.de/doc/index.html"><i class="bi bi-arrow-right m-1"></i>Developer Documentation</a>
+<a class="btn btn-primary text-black" href="/api/"><i class="bi bi-arrow-right m-1"></i>Developer Documentation</a>
 
 <h2>Public Transport Coverage</h2>
 <p>If you know where to find public transport data for your region, or if you are a public transport operator, you can help by adding the feed to our data set.</p>
diff --git a/website/content/api.html b/website/content/api.html
new file mode 100644
index 00000000..3a1ea0a3
--- /dev/null
+++ b/website/content/api.html
@@ -0,0 +1,24 @@
+---
+title: "API"
+omit_header_text: true
+featured_image: ''
+menu: main
+---
+
+<h1>MOTIS 2 API</h1>
+
+<p>Transitous provides the MOTIS 2 API. It is the first stable and versioned MOTIS API, and is incompatible with previous development versions of the API.</p>
+
+<p>Our API endpoint is located at <code>https://api.transitous.org/api/v1/</code>.</p>
+
+<a class="btn btn-primary text-black" href="https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/motis-project/motis/refs/heads/master/openapi.yaml">API Documentation</a>
+
+<h2>Legacy API (MOTIS 0.x)</h1>
+
+<p>For a few more weeks, the legacy API is available at <code>https://routing.spline.de/api/</code> for compatibility with apps that have not been updated yet.</p>
+
+<p>It will be shut down 1 month after the deployment of MOTIS 2.</p>
+
+<p>The data on the legacy server is no longer kept up to date.</p>
+
+<a class="btn btn-primary text-black" href="https://routing.spline.de/doc/index.html">API Documentation</a>
diff --git a/website/layouts/shortcodes/source-table.html b/website/layouts/shortcodes/source-table.html
index f819b470..341b7793 100644
--- a/website/layouts/shortcodes/source-table.html
+++ b/website/layouts/shortcodes/source-table.html
@@ -4,16 +4,6 @@
 SPDX-License-Identifier: AGPL-3.0-or-later
 -->
 
-<style>
-h3 {
-  margin-top: 30px;
-}
-
-h2 {
-  margin-top: 60px;
-}
-</style>
-
 {{ range $index, $source := $.Site.Data.license }}
   {{ if not (compare.Eq ((index $.Site.Data.license $index).region_name) ((index $.Site.Data.license (sub $index 1)).region_name)) }}
     <h2>{{ .region_name }}</h2>
diff --git a/website/static/custom.css b/website/static/custom.css
index 9f1a1d59..4e1b1bbd 100644
--- a/website/static/custom.css
+++ b/website/static/custom.css
@@ -54,3 +54,11 @@
 .text-xs {
   font-size: 10px;
 }
+
+h3 {
+  margin-top: 30px;
+}
+
+h2 {
+  margin-top: 60px;
+}