docs(@datadive/docs): improve dosumentation landing page, about page and sidebar

Author: lucaschultz

apps/docs/astro.config.ts

@@ -39,6 +39,24 @@ export default defineConfig({
             collapsed: false,
           },
         },
+        {
+          label: 'Datadive API',
+          collapsed: true,
+          items: [
+            {
+              label: 'Specification',
+              link: '/spec',
+            },
+            {
+              label: 'OpenAPI (JSON)',
+              link: '/openapi.json',
+            },
+            {
+              label: 'OpenAPI (YAML)',
+              link: '/openapi.yml',
+            },
+          ],
+        },
       ],
     }),
   ],

apps/docs/src/content/docs/about.md

@@ -1,3 +1,9 @@
 ---
 title: About the Docs
 ---
+
+This documentation was written as part of Luca Schultz's bachelor thesis *"Implementing Datadive: A Web Application for Data Analysis"* at the Behavioral Security Research Group at the University of Bonn in November 2024.
+
+The thesis is available as a [PDF](/thesis.pdf) and can be read online [here](/thesis/introduction).
+
+The source code for the Datadive platform is available on [GitHub](https://github.com/lucaschultz/datadive).

apps/docs/src/content/docs/index.mdx

@@ -5,27 +5,35 @@ template: splash
 hero:
   tagline: Here you will find all the information you need to contribute to Datadive.
   actions:
-    - text: Project Setup
-      link: /guides/example/
+    - text: Learn More
+      link: /about
       icon: right-arrow
       variant: primary
 ---
 
-import { Card, CardGrid } from '@astrojs/starlight/components'
+import { LinkCard, CardGrid, Card } from '@astrojs/starlight/components'
 
 ## Next steps
 
-<CardGrid>
-  <Card title='Add new content' icon='add-document'>
-    Add Markdown or MDX files to `src/content/docs` to create new pages.
-  </Card>
-  <Card title='Update content' icon='add-document'>
-    Edit `src/content/docs/index.mdx` to
-  </Card>
-  <Card title='Configure your site' icon='setting'>
-    Edit your `sidebar` and other config in `astro.config.mjs`.
-  </Card>
-  <Card title='Read the docs' icon='open-book'>
-    Learn more in [the Starlight Docs](https://starlight.astro.build/).
-  </Card>
+<CardGrid stagger>
+  <LinkCard
+    href="thesis/introduction"
+    title='Read the thesis online'
+    description="Learn more about the Datadive platform in the Luca's bachelors thesis."
+  />
+  <LinkCard
+    href="/thesis.pdf"
+    title='Download the thesis'
+    description="Download Luca's bachelor thesis as a PDF file to read it offline."
+  />
+  <LinkCard
+    href="https://github.com/lucaschultz/datadive"
+    title='Check out the GitHub repository'
+    description='Contribute to the Datadive platform by checking out the source code on GitHub.'
+  />
+  <LinkCard
+    href="/spec"
+    title='Check out the API specification'
+    description='Learn more about the Datadive HTTP API by checking out the OpenAPI specification.'
+  />
 </CardGrid>