docs: clean up mkdocs

Author: lineargraph

src/doc/docs/config/index.md

@@ -1,16 +1,20 @@
 # Config GUI
 
-The config GUI is the main selling point of MoulConfig.
+The config GUI is the main selling point of MoulConfig. It can be manually constructed using a [`ConfigStructureReader` subclass](../javadocs/common/io.github.notenoughupdates.moulconfig.processor/-config-structure-reader/index.html),
+or by using [`ConfigProcessorDriver`](../javadocs/common/io.github.notenoughupdates.moulconfig.processor/-config-processor-driver/index.html) or the [`ManagedConfig` (for full automation of config saving and displaying)](../javadocs/common/io.github.notenoughupdates.moulconfig.managed/-managed-config/index.html)
 
 ## Structure
 
 The config structure is roughly mapped to Java classes. Each category, subcategory and accordion is its own Java object.
 
-The base class needs to extend `Config` and each field needs to be non-static. This way your config is also easily
+The base class needs to extend [`Config`](../javadocs/common/io.github.notenoughupdates.moulconfig/-config/index.html) and each field needs to be non-static. This way your config is also easily
 serializable as a Json Object. MoulConfig is however completely agnostic towards your configs save format. The only
 requirement is that instances do not get reassigned. So updating the config object after you have processed a config
 requires that config to be reprocessed (and old MoulConfig to be discarded).
 
+If you specifically do want MoulConfig to load and save files for you, consider obtaining the instance of your config
+through [`ManagedConfig`](../javadocs/common/io.github.notenoughupdates.moulconfig.managed/-managed-config/index.html)
+
 ### Top Level Structure
 
 You can specify categories

src/doc/docs/index.md

@@ -11,20 +11,25 @@ under an LGPL 3.0 license, and this version keeps that license.
 This version of MoulConfig is published to the [NEU Maven Repository][neurepo]. The latest
 version number can be [found there as well][versionlisting].
 
-There are two versions of MoulConfig: `legacy` for 1.8.9 and `modern` for 1.20.2. Legacy has support for the config gui
-and for the gui library, while modern only supports the gui library.
+MoulConfig is split into two parts:
 
-### Legacy installation
+- `common`, which contains logic for rendering, annotation processing, and most of the code you will interact with
+- `platform`, which contains code for coupling rendering and input with one specific platform
+    - `modern-<version>`, which contains compatibility code for modern minecraft versions (1.20+)
+    - `legacy`, which contains 1.8.9 compatibility code
 
-On 1.8.9 Forge you will need to shadow MoulConfig like any other mod dependency. It is *highly* recommended that
-you relocate MoulConfig to another package, since our internals do not obey any backwards compatibility guarantees.
-In order to get resources loaded in your development environment is is recommended that you also make use of the
-`io.github.notenoughupdates.moulconfig.tweaker.DevelopmentResourceTweaker`. Do not specify this tweaker in your JAR manifest,
-*only* as a command line argument during development time. See a snippet on how to use MoulConfig with architectury loom
-below:
+### Modern installation
 
-```kotlin
+Just shadow MoulConfig like any other mod. It is *highly* recommended that you relocate MoulConfig to another package,
+since our internals do not obey any backwards compatibility guarantees. No other buildscript configuration is necessary.
+
+Each minecraft version has its own `modern-<minecraftVersion>` module. Those modules automatically contain the corresponding
+`common` code for the relevant MoulConfig version.
 
+You will also need to copy the relevant `moulconfig.accesswidener` to your own. Check the relevant source directory for
+used accesswideners. In the future there might be a plugin to automatically shade / combine accesswideners.
+
+```kt
 repositories {
     maven("https://maven.notenoughupdates.org/releases/")
 }
@@ -37,16 +42,7 @@ val shadowModImpl by configurations.creating {
 
 dependencies {
     // Where shadowModImpl is a gradle configuration that remaps and shades the jar.
-    "shadowModImpl"("org.notenoughupdates.moulconfig:legacy:<version>")
-}
-
-// This snippet is required in order to correctly load resources in the development environment
-loom {
-    launchConfigs {
-        "client" {
-            arg("--tweakClass", "io.github.notenoughupdates.moulconfig.tweaker.DevelopmentResourceTweaker")
-        }
-    }
+    "shadowModImpl"("org.notenoughupdates.moulconfig:modern-<mcversion>:<version>")
 }
 
 tasks.shadowJar {
@@ -56,25 +52,30 @@ tasks.shadowJar {
 }
 ```
 
-### Modern installation
+### Legacy installation
 
-Just shadow MoulConfig like any other mod. It is *highly* recommended that you relocate MoulConfig to another package,
-since our internals do not obey any backwards compatibility guarantees. No other buildscript configuration is necessary.
+On 1.8.9 Forge you will need to shadow MoulConfig like any other mod dependency. It is *highly* recommended that
+you relocate MoulConfig to another package, since our internals do not obey any backwards compatibility guarantees.
+In order to get resources loaded in your development environment is is recommended that you also make use of the
+`io.github.notenoughupdates.moulconfig.tweaker.DevelopmentResourceTweaker`. Do not specify this tweaker in your JAR manifest,
+*only* as a command line argument during development time. See a snippet on how to use MoulConfig with architectury loom
+below:
+
+```kotlin
 
-```kt
 repositories {
     maven("https://maven.notenoughupdates.org/releases/")
 }
 
-// Your gradle template probably already includes something like this configuration.
+// Your Gradle template probably already includes something like this configuration.
 // **Make sure that the configuration is extending modImplementation, otherwise you will run into name issues**
 val shadowModImpl by configurations.creating {
     configurations.modImplementation.get().extendsFrom(this)
 }
 
 dependencies {
     // Where shadowModImpl is a gradle configuration that remaps and shades the jar.
-    "shadowModImpl"("org.notenoughupdates.moulconfig:modern:<version>")
+    "shadowModImpl"("org.notenoughupdates.moulconfig:legacy:<version>")
 }
 
 tasks.shadowJar {
@@ -88,7 +89,7 @@ tasks.shadowJar {
 ## Usage
 
 See
-the [TestMod](https://github.com/NotEnoughUpdates/MoulConfig/blob/master/modern/src/main/kotlin/io/github/notenoughupdates/moulconfig/test)
+the [FabricMain](https://github.com/NotEnoughUpdates/MoulConfig/blob/v4/modern/templates/java/io/github/notenoughupdates/moulconfig/test/FabricMain.java)
 for usage examples, or check out the annotation
 package documentation to see the kind of config variable editors MoulConfig has built in.
 

src/doc/mkdocs.yml

@@ -5,8 +5,8 @@ site_url: https://notenoughupdates.org/MoulConfig
 
 repo_name: MoulConfig
 repo_url: https://github.com/NotEnoughUpdates/MoulConfig
-edit_uri: edit/master/src/doc/docs/
-copyright: 'Copyright © 2023 Linnea Gräf'
+edit_uri: edit/v4/src/doc/docs/
+copyright: 'Copyright © 2025 Linnea Gräf'
 
 plugins:
   - zettelkasten
@@ -32,5 +32,6 @@ nav:
   - Javadocs:
       - Home: javadocs/index.html
       - Common: javadocs/common/index.html
-      - Legacy: javadocs/legacy/index.html
+      - Modern Platform: javadocs/modern/index.html
+      - Legacy Platform: javadocs/legacy/index.html
       - Annotations: javadocs/common/io.github.notenoughupdates.moulconfig.annotations/index.html