Large-scale docs cleanup

Author: gtaylor

README.md

@@ -1,13 +1,22 @@
-# StompyMUX
-
-StompyMUX is a 
-
-For more details, see the [StompyMUX Documentation](https://gtaylor.github.io/stompymux/docs/introduction/).
+StompyMUX is a game server for creating and hosting text-based multiplayer games about Big Stompy Robots.
+It comes with a real-time combat system with AI, a unit repair system, economic building blocks, and much more.
 
 ## Status
 
 StompyMUX is an occasionally developed modernization fork of [BattletechMUX](https://sourceforge.net/projects/btonline-btech/).
+Our foundations are built from more than [three decades of contributions](./docs/content/en/docs/history.md).
+While the features in this codebase are very well fleshed out, we may occasionally break things, including backwards compatibility!
+
+## Getting involved
+
+Contributions are welcomed.
+See the [Contributing](./docs/content/en/docs/contributing.md) guide.
+Visit our [Discord server](https://discord.gg/TJzQByY2nC) to reach the rest of the developer community.
+
+## Support
+
+No support is guaranteed, but you may be able to get help on our [Discord server](https://discord.gg/TJzQByY2nC).
 
 ## License
 
-StompyMUX inherits an Artistic License, included in [LICENSE.md](./LICENSE.md).
+StompyMUX inherits an Artistic License, included in [LICENSE.md](https://github.com/gtaylor/stompymux/blob/main/LICENSE.md) in the source distribution.

docs/assets/icons/logo.png

@@ -1,8 +1,7 @@
 ---
 title: Concepts
 linkTitle: Concepts
+description: Deeper dives on how StompyMUX works
 type: docs
 weight: 25
 ---
-
-Background and architecture concepts for BattleTechMUX.

docs/assets/icons/logo.svg

@@ -1,10 +1,9 @@
 ---
-title: "BattleTech Architecture"
+title: BattleTech Architecture
 weight: 25
+description: An architectural overview of the codebase
 ---
 
-# BattleTech architecture
-
 BattleTech is a domain-oriented package rooted at `src/btech`. Its public
 boundary is `src/btech/include/btech`; MUX code must not include any other
 BattleTech directory.

docs/content/en/docs/concepts/_index.md

@@ -1,6 +1,7 @@
 ---
 title: Channel administration
 linkTitle: Channel administration
+description: How to administer in-game communication channels
 type: docs
 weight: 30
 ---

docs/content/en/docs/concepts/btech-architecture.md

@@ -1,6 +1,7 @@
 ---
 title: Help system
 linkTitle: Help system
+description: How the in-game help system works
 type: docs
 weight: 20
 ---
@@ -24,12 +25,12 @@ starts with a TOML frontmatter block delimited by `+++` lines, followed by
 the markdown body:
 
 ```markdown
-+++
-title = "About this game"
-description = "All about this game"
-keywords = ["about"]
-article_tags = ["show_in_index"]
-+++
+---
+title: About this game
+description: All about this game
+keywords: [about]
+article_tags: [show_in_index]
+---
 
 # About this game
 

docs/content/en/docs/concepts/channel-administration.md

@@ -1,9 +1,7 @@
-+++
-title = "Player account state"
-description = "How authentication, login history, and page memory are stored"
-+++
-
-# Player account state
+---
+title: Player account state
+description: How authentication, login history, and page memory are stored
+---
 
 Player authentication and activity metadata are typed server state rather than
 object attributes. The SQLite `player_state` table stores password hashes,

docs/content/en/docs/concepts/help-system.md

@@ -1,6 +1,7 @@
 ---
 title: Source layout
 linkTitle: Source layout
+description: How the codebase is organized
 type: docs
 weight: 10
 ---

docs/content/en/docs/concepts/player-account-state.md

@@ -1,6 +1,7 @@
 ---
 title: Styled object text
 linkTitle: Styled text
+description: How to style in-game text
 type: docs
 weight: 30
 ---