Add missing plugins and reorganize to fit mkdocs structure better

Author: BrandonKowalski

.github/CONTRIBUTING.md

@@ -1,90 +1,3 @@
 # Contributing to Grout
 
-First off, thank you for considering contributing to Grout! We appreciate your time and effort.
-
-Before implementing major features, please open an issue or discuss it in the
-[Grout Development Channel](https://discord.com/channels/1138838206532554853/1456747141518069906) on the
-[RomM Discord](https://discord.gg/P5HtHnhUDH) to ensure alignment with the project's direction.
-
-## Code of Conduct
-
-By contributing, you agree to uphold our [Code of Conduct](CODE_OF_CONDUCT.md). Be respectful, constructive, and
-welcoming to all contributors regardless of experience level.
-
-## Ways to Contribute (No Coding Required)
-
-Not a developer? There are many ways to help improve Grout!
-
-### Translations
-
-Help make Grout accessible to more users by translating it into your language. Translation files are located in `resources/locales/`. 
-
-See the [Development Guide](/old_docs/DEVELOPMENT.md#internationalization-i18n) for details on the i18n workflow.
-
-### Testing & Bug Reports
-
-- Test Grout on your device and CFW combination
-- Report bugs with detailed reproduction steps
-- Verify fixes in pre-release builds
-- Test edge cases (slow networks, large libraries, etc.)
-
-### Documentation
-
-- Fix typos and improve clarity in guides
-- Write tutorials for specific use cases
-- Add screenshots or animated demos
-- Translate documentation
-
-### Platform Mapping Updates
-
-Help keep CFW platform directory mappings current:
-- Report incorrect or missing platform mappings for your CFW
-- Test new CFW releases and note any directory structure changes
-
-### Community Support
-
-- Help answer questions in the [RomM Discord](https://discord.gg/P5HtHnhUDH)
-- Share tips and workflows with other users
-- Welcome new community members
-
----
-
-## Getting Started (Developers)
-
-1. Read the [Development Guide](/old_docs/DEVELOPMENT.md) for setup instructions
-2. Fork and clone the repository
-3. Create a feature branch from `main` with a descriptive name (e.g., `feature/add-search-filter`)
-4. Make your changes
-5. Test locally on your target CFW if possible
-6. Commit with clear, descriptive messages
-7. Push and open a pull request against `main`
-
-## Pull Request Standards
-
-- Follow existing code conventions and patterns
-- Test your changes locally before submitting
-- Update documentation if your changes affect user-facing behavior
-- Ensure the build passes (`task build` or `go build ./...`)
-- Provide a clear description of what your PR does and why
-
-## Code Style
-
-We use standard Go formatting and conventions:
-
-- Run `go fmt` before committing
-- Use `go vet` and `staticcheck` to catch issues
-- Follow existing patterns in the codebase for consistency
-
-## Reporting Bugs
-
-Please [create an issue](https://github.com/rommapp/grout/issues/new/choose) with:
-
-- Your CFW and version (muOS, Knulli, Spruce, NextUI)
-- Grout version
-- Steps to reproduce the issue
-- Expected vs actual behavior
-- Any relevant logs or screenshots
-
-## License
-
-By contributing, you agree that your contributions will be licensed under the MIT License.
+For contribution guidelines, please see our documentation: https://grout.romm.app/development/

docs/development/development.md

@@ -4,11 +4,7 @@
     These instructions were written with macOS in mind. It should work elsewhere, but we have
     not personally verified this.
 
-We hang out over in
-the [Grout Development Channel](https://discord.com/channels/1138838206532554853/1456747141518069906) on
-the [RomM Discord](https://discord.gg/P5HtHnhUDH). Come join us!
-
----
+We hang out over in the [Grout Development Channel](https://discord.com/channels/1138838206532554853/1456747141518069906) on the [RomM Discord](https://discord.gg/P5HtHnhUDH). Come join us!
 
 ## Prerequisites
 
@@ -27,8 +23,6 @@ brew install sdl2 sdl2_image sdl2_ttf sdl2_gfx
 - [Docker Desktop](https://www.docker.com/products/docker-desktop/) or equivalent
     - We love [OrbStack](https://orbstack.dev) (not a sponsor)
 
----
-
 ## Getting Started
 
 1. Clone the [Grout](https://github.com/rommapp/grout) repository.
@@ -44,8 +38,6 @@ brew install sdl2 sdl2_image sdl2_ttf sdl2_gfx
       muOS). Have the subdirectory structure of this path match the CFW you are working on.
 5. Run / Debug `app/grout.go`, making sure to reference the `.env` file in your run configuration.
 
----
-
 ## Project Structure
 
 The codebase is laid out fairly well. It attempts to keep everything grouped by feature / function / domain.
@@ -67,8 +59,6 @@ The codebase is laid out fairly well. It attempts to keep everything grouped by
 - `version` exposes the version information that is injected at build time. Having it as its own package made the script
   cleaner.
 
----
-
 ## Packaging
 
 The `taskfile.yml` defines scripts for building and packaging Grout for various CFWs. All builds target ARM64 Linux
@@ -110,7 +100,7 @@ into the appropriate directory structure for that CFW.
 
 ### Deployment via ADB
 
-For rapid testing, you can deploy directly to a connected device:
+For rapid testing, you can deploy directly to a connected device, assuming that the device has ADB available:
 
 ```shell
 # NextUI (TrimUI devices)
@@ -153,8 +143,6 @@ build/
 └── Spruce/Grout/      # Spruce package
 ```
 
----
-
 ## Helper Tools
 
 The `taskfile.yml` includes several utility tasks for common development workflows.

docs/development/contributing.md docs/development/index.mddocs/development/contributing.md renamed to docs/development/index.md

@@ -1,17 +1,18 @@
 # Contributing to Grout
 
-First off, thank you for considering contributing to Grout! We appreciate your time and effort.
+Thank you for considering contributing to Grout! We appreciate your time and effort.
 
 Before implementing major features, please open an issue or discuss it in the
 [Grout Development Channel](https://discord.com/channels/1138838206532554853/1456747141518069906) on the
 [RomM Discord](https://discord.gg/P5HtHnhUDH) to ensure alignment with the project's direction.
 
 ## Code of Conduct
 
-By contributing, you agree to uphold our Code of Conduct. Be respectful, constructive, and
-welcoming to all contributors regardless of experience level.
+By contributing, you agree to uphold our [Code of Conduct](https://github.com/rommapp/grout/blob/main/.github/CODE_OF_CONDUCT.md).
 
-## Ways to Contribute (No Coding Required)
+Be respectful, constructive, and welcoming to all contributors regardless of experience level.
+
+## Ways to Contribute
 
 Not a developer? There are many ways to help improve Grout!
 
@@ -48,8 +49,6 @@ Help keep CFW platform directory mappings current:
 - Share tips and workflows with other users
 - Welcome new community members
 
----
-
 ## Getting Started (Developers)
 
 1. Read the [Development Guide](development.md) for setup instructions

docs/development/kudos.md

@@ -2,7 +2,7 @@
 
 Thank you to everyone who has contributed to Grout!
 
-## ~~Fearful Leader~~ Maintainer
+## ~~Fearful Leader~~ Lead Maintainer { data-toc-label="Lead Maintainer" }
 
 - **Brandon T. Kowalski** ([@BrandonKowalski](https://github.com/BrandonKowalski))
 
@@ -13,11 +13,3 @@ Thank you to everyone who has contributed to Grout!
 - **Huynh Duc Dung** ([@jellydn](https://github.com/jellydn))
 - **Sargun Vohra** ([@sargunv](https://github.com/sargunv))
 - **Zach Keatings** ([@zkeatings](https://github.com/zkeatings))
-
----
-
-### Spread Joy!
-
-A significant amount of time has been spent building Grout.
-
-If you enjoy using Grout and feel inclined to pay it forward, go do something nice for someone!

docs/development/state-machine.md

@@ -1,4 +1,4 @@
-# State Machine
+# State Machine Reference
 
 This document shows the navigation flow between screens in Grout.
 
@@ -147,33 +147,3 @@ flowchart TD
 | Logout Confirmation           | Confirm logout action                          |
 | Save Sync                     | Manual save synchronization                    |
 | BIOS Download                 | Download BIOS files                            |
-
----
-
-## Navigation State
-
-The FSM maintains state in a `NavState` struct:
-
-```go
-type NavState struct {
-    CurrentGames []romm.Rom
-    FullGames    []romm.Rom
-    SearchFilter string
-    HasBIOS      bool
-    GameListPos  ListPosition
-
-    CollectionSearchFilter string
-    CollectionGames        []romm.Rom
-    CollectionListPos      ListPosition
-    CollectionPlatformPos  ListPosition
-
-    PlatformListPos ListPosition
-
-    SettingsPos            ListPosition
-    CollectionsSettingsPos ListPosition
-    AdvancedSettingsPos    ListPosition
-
-    QuitOnBack      bool
-    ShowCollections bool
-}
-```

docs/getting-started/index.md

@@ -40,7 +40,7 @@ Enter your connection details:
 Press `Start` to connect.
 
 !!! tip
-    Using a self-signed certificate? Set **SSL Certificates** to **Skip Verification**.
+Using a self-signed certificate? Set **SSL Certificates** to **Skip Verification**.
 
 ### Step 4: Map Your Platforms
 
@@ -49,6 +49,7 @@ Tell Grout where to save games for each platform:
 - **Skip** - Don't download games for this platform
 - **Create {Directory}** - Let Grout create a new folder
 - **/{Existing Directory}** - Use an existing folder
+- **Custom** - Specify a custom path
 
 Press `Start` when done.
 
@@ -64,6 +65,6 @@ That's it! Your game is now on your device.
 
 ## What's Next?
 
-- [Full User Guide](../guide/user-guide.md) - Complete feature documentation
-- [Settings Reference](../guide/settings.md) - Configure Grout to your preferences
-- [Save Sync Guide](../guide/save-sync.md) - Keep saves synchronized across devices
+- [Full User Guide](../usage/guide.md) - Complete feature documentation
+- [Settings Reference](../usage/settings.md) - Configure Grout to your preferences
+- [Save Sync Guide](../usage/save-sync.md) - Keep saves synchronized across devices

docs/getting-started/install-knulli.md

@@ -45,4 +45,4 @@ file if you do not want to authenticate again, and configure platforms folder ma
 
 ## Next Steps
 
-After installation is complete, check out the [User Guide](../guide/user-guide.md) to learn how to use Grout.
+After installation is complete, check out the [User Guide](../usage/guide.md) to learn how to use Grout.

docs/getting-started/install-muos.md

@@ -43,4 +43,4 @@ sure to keep the `config.json` file if you do not want to authenticate again, an
 
 ## Next Steps
 
-After installation is complete, check out the [User Guide](../guide/user-guide.md) to learn how to use Grout.
+After installation is complete, check out the [User Guide](../usage/guide.md) to learn how to use Grout.

docs/getting-started/install-nextui.md

@@ -53,4 +53,4 @@ file if you do not want to authenticate again, and configure platforms folder ma
 
 ## Next Steps
 
-After installation is complete, check out the [User Guide](../guide/user-guide.md) to learn how to use Grout.
+After installation is complete, check out the [User Guide](../usage/guide.md) to learn how to use Grout.

docs/getting-started/install-rocknix.md

@@ -46,4 +46,4 @@ file if you do not want to authenticate again, and configure platforms folder ma
 
 ## Next Steps
 
-After installation is complete, check out the [User Guide](../guide/user-guide.md) to learn how to use Grout.
+After installation is complete, check out the [User Guide](../usage/guide.md) to learn how to use Grout.