Docs upgrade

README.md

@@ -9,22 +9,13 @@
 
 ## Modrinth Monorepo
 
-Welcome to the Modrinth Monorepo, the primary codebase for the Modrinth web interface and app. It contains ![Lines](https://img.shields.io/endpoint?url=https://ghloc.vercel.app/api/modrinth/olympus/badge?logoColor=white&color=black&label=) lines of code and has ![Contributors](https://img.shields.io/github/contributors/Modrinth/code?color=black&label=) contributors!
+Welcome to the Modrinth Monorepo, the primary codebase for Modrinth projects. It contains ![Lines](https://img.shields.io/endpoint?url=https://ghloc.vercel.app/api/modrinth/olympus/badge?logoColor=white&color=black&label=) lines of code and has ![Contributors](https://img.shields.io/github/contributors/Modrinth/code?color=black&label=) contributors!
 
 If you're not a developer and you've stumbled upon this repository, you can access the web interface on the [Modrinth website](https://modrinth.com) and download the latest release of the app [here](https://modrinth.com/app).
 
-## Development
+## Development and contributing
 
-This repository contains two primary packages. For detailed development information, please refer to their respective READMEs:
-
-- [Web Interface](apps/frontend/README.md)
-- [Desktop App](apps/app/README.md)
-
-## Contributing
-
-We welcome contributions! Before submitting any contributions, please read our [contributing guidelines](https://docs.modrinth.com/contributing/getting-started/).
-
-If you plan to fork this repository for your own purposes, please review our [copying guidelines](COPYING.md).
+You can read more about the codebase and how to contribute to it on the [contributing documentation page](https://docs.modrinth.com/contributing/modrinth/). 
 
 ## Security
 

apps/app/README.md

@@ -1,29 +1,9 @@
 # ![Modrinth App](/.github/assets/app_cover.png)
 
-## Modrinth App
+## Modrinth App (Theseus)
 
-The Modrinth App is a desktop application for managing your Minecraft mods. It is built with [Tauri](https://tauri.app/) and [Vue](https://vuejs.org/).
+[Theseus](https://modrinth.com/app) is Modrinth's Minecraft launcher that lets users play with any projects like mods, shaders and modpacks aviable on [Modrinth](https://modrinth.com/).
 
 If you're not a developer and you've stumbled upon this repository, you can download the latest release of the app from the [Modrinth website](https://modrinth.com/app).
 
-## Development
-
-### Pre-requisites
-
-Before you begin, ensure you have the following installed on your machine:
-
-- [Node.js](https://nodejs.org/en/)
-- [pnpm](https://pnpm.io/)
-- [Rust](https://www.rust-lang.org/tools/install)
-- [Tauri](https://v2.tauri.app/start/prerequisites/)
-
-### Setup
-
-Follow these steps to set up your development environment:
-
-```bash
-pnpm install
-pnpm app:dev
-```
-
-You should now have a development build of the app running with hot-reloading enabled. Any changes you make to the code will automatically refresh the app.
+Read more about this projects and how to contribute to it on the [theseus contributing page](https://docs.modrinth.com/contributing/theseus/).

apps/daedalus_client/README.md

@@ -1,4 +1,4 @@
-# Daedalus
+# Daedalus (Metadata service)
 
 Daedalus is a powerful tool which queries and generates metadata for the Minecraft (and other games in the future!) game
 and mod loaders for:
@@ -8,3 +8,5 @@ and mod loaders for:
 - Reliability (Provides a versioning system which ensures no breakage with updates)
 
 Daedalus supports the original Minecraft data and reposting for the Forge, Fabric, Quilt, and NeoForge loaders.
+
+Read more about this projects and how to contribute to it on the [Daedalus contributing page](https://docs.modrinth.com/contributing/daedalus/).

apps/docs/README.md

@@ -1,23 +1,5 @@
-# Modrinth Documentation
+# Modrinth docs
 
-Welcome to the Modrinth documentation!
+Welcome to the Modrinth documentation repository!
 
-## Development
-
-### Pre-requisites
-
-Before you begin, ensure you have the following installed on your machine:
-
-- [Node.js](https://nodejs.org/en/)
-- [pnpm](https://pnpm.io/)
-
-### Setup
-
-Follow these steps to set up your development environment:
-
-```bash
-pnpm install
-pnpm docs:dev
-```
-
-You should now have a development build of the documentation site running with hot-reloading enabled. Any changes you make to the code will automatically refresh the browser.
+Read more about the project and how to contribute on the [docs documentation page](https://github.com/modrinth/code/blob/main/CONTRIBUTING.md).

apps/docs/astro.config.mjs

@@ -13,11 +13,12 @@ export default defineConfig({
         baseUrl: 'https://github.com/modrinth/code/edit/main/apps/docs/',
       },
       social: {
+        blueSky: 'https://bsky.app/profile/modrinth.com',
         github: 'https://github.com/modrinth/code',
         discord: 'https://discord.modrinth.com',
-        'x.com': 'https://x.com/modrinth',
         mastodon: 'https://floss.social/@modrinth',
         threads: 'https://threads.net/@modrinth',
+        'x.com': 'https://x.com/modrinth'
       },
       logo: {
         light: './src/assets/light-logo.svg',
@@ -34,18 +35,19 @@ export default defineConfig({
         starlightOpenAPI([
           {
             base: 'api',
-            label: 'Modrinth API',
+            label: 'Labrinth (API)',
             schema: './public/openapi.yaml',
           },
         ]),
       ],
       sidebar: [
+        { slug: 'overview' },
+        // Add the generated sidebar group to the sidebar.
+        ...openAPISidebarGroups,
         {
           label: 'Contributing to Modrinth',
           autogenerate: { directory: 'contributing' },
         },
-        // Add the generated sidebar group to the sidebar.
-        ...openAPISidebarGroups,
       ],
     }),
   ],

apps/docs/src/content/docs/contributing/ariadne.mdx

@@ -0,0 +1,8 @@
+---
+title: Ariadne
+description: Ariadne contributing guide
+---
+
+The codebase is kept in Modrinth's [monorepo](https://github.com/modrinth/code). You can find it in the [`packages/ariadne`](https://github.com/modrinth/code/tree/main/packages/ariadne) directory.
+
+Work in progress...

apps/docs/src/content/docs/contributing/daedalus.mdx

@@ -0,0 +1,25 @@
+---
+title: Daedalus (Metadata service)
+description: Daedalus contributing guide
+---
+
+import { Steps } from '@astrojs/starlight/components';
+
+[Daedalus](https://github.com/modrinth/code/tree/main/packages/daedalus) is a library providing model structs and methods for requesting and parsing things from Minecraft and other mod loaders meta APIs.
+
+The codebase is kept in Modrinth's [monorepo](https://github.com/modrinth/code).
+
+## Architecture
+
+Daedalus is split up into two parts:
+
+- [`packages/daedalus`](https://github.com/modrinth/code/tree/main/apps/daedalus_client): The library holding all the core logic for the service
+- [`apps/daedalus_client`](https://github.com/modrinth/code/tree/main/apps/daedalus_client): The service worker that runs in the background and handles requests
+
+## Ready to open a PR?
+
+<Steps>
+
+1. Open a pull request on the [monorepo repository](https://github.com/modrinth/code)
+
+</Steps>

apps/docs/src/content/docs/contributing/docs.mdx

@@ -0,0 +1,46 @@
+---
+title: Docs
+description: Docs contributing guide
+---
+
+import { Steps } from '@astrojs/starlight/components';
+
+Modrinth Docs is the site you are looking at right now. It's here to help us work with Modrinth's projects and provide various information.
+
+The Docs are built using [Astro](https://astro.build) a content focused framework and the [Starlight](https://starlight.astro.build) integration specifically designed for documentation sites.
+
+The codebase is kept in Modrinth's [monorepo](https://github.com/modrinth/code). You can find it in the [`/apps/docs`](https://github.com/modrinth/code/tree/main/apps/docs) directory.
+
+## Setup
+
+<Steps>
+
+1. Follow [Getting started](/contributing/getting-started#installation) guide
+
+2. Start the development server from the root of the monorepo by running
+    ```bash
+    pnpm run docs:dev
+    ```
+
+    or inside the docs directory, as it doesn't rely on any internal package to be built, by running
+    ```bash
+    pnpm run dev
+    ```
+
+2. Open you browser at [http://localhost:4321](http://localhost:4321)
+
+</Steps>
+
+Pages are written using [Markdown](https://www.markdownguide.org/basic-syntax) and [MDX](https://mdxjs.com) and are stored in the `/src/content/docs` directory.
+The [Labrinth API docs](/api) are auto generated with [starlight-openapi](https://github.com/HiDeoo/starlight-openapi) from the `/public/openapi.yaml` file.
+
+
+## Ready to open a PR?
+
+<Steps>
+
+1. While there is no linting requirement, we do ask that you quickly check your code before opening a pull request.
+
+1. Open a pull request on the [monorepo repository](https://github.com/modrinth/code)
+
+</Steps>

apps/docs/src/content/docs/contributing/getting-started.mdx

@@ -0,0 +1,56 @@
+---
+title: Getting started
+description: Setup your environment to contribute to Modrinth
+sidebar:
+  order: 1
+---
+
+import { Steps } from '@astrojs/starlight/components';
+
+Most of Modrinth's code is in our [monorepo](https://github.com/modrinth/code) which is powered by [Turborepo](https://turborepo.org).
+Modrinth projects are written using languages like [Rust](https://www.rust-lang.org), [Java](https://www.java.com) and frameworks like [Nuxt](https://nuxtjs.org) and [Astro](https://astro.build).
+
+## Prerequisites
+- [Node](https://nodejs.org) installed on your machine
+- [Pnpm](https://pnpm.io) installed on your machine
+
+Some projects may require additional tooling and setups and they will be specified in their respective pages.
+
+## Installation
+
+<Steps>
+
+1. Fork Modrinth's [monorepo](https://github.com/modrinth/code) from GitHub
+
+   :::note
+   Please be awere and read about our [copying guidelines](https://github.com/modrinth/code/blob/main/COPYING.md) regarding some content you'll find in the monorepo
+   :::
+
+2. Open the monorepo with your preferred code editor
+
+2. Install the dependencies by running
+    ```bash
+    pnpm install
+    ```
+
+</Steps>
+
+## Projects
+
+Project-specific documentation pages:
+
+Apps:
+- [Daedalus (Metadata service)](/contributing/daedalus)
+- [Docs](/contributing/docs)
+- [Knossos (Frontend)](/contributing/knossos)
+- [Labrinth (API)](/contributing/labrinth)
+- [Theseus (Modrinth App)](/contributing/theseus)
+
+Packages:
+- [Ariadne](/contributing/ariadne)
+- [Omorphia (Assets)](/contributing/assets)
+- [Minotaur (Gradle plugin)](/contributing/minotaur)
+- [Ui](/contributing/ui)
+- [Utils](/contributing/utils)
+
+Modrinth developers are silly so they decided to name their projects after greek mitology lore