feat(markdownlint): enhance markdownlint configuration and update commands in documentation

- Added new rules MD058 (blanks around tables), MD059 (descriptive link text), and MD060 (table column style) to the markdownlint configuration for improved markdown quality.
- Updated the pre-commit configuration to use the markdownlint-fix hook for automatic formatting.
- Introduced a new section in AGENTS.md for configuration commands, providing users with clear instructions for generating and validating configuration files.
- Removed the Quick Commands section from README.md to streamline the documentation and avoid redundancy.

Author: kzndotsh

.markdownlint.yaml

@@ -223,3 +223,15 @@ MD055:
   style: consistent
 # MD056/table-column-count : Table column count : https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md056.md
 MD056: true
+# MD058/blanks-around-tables : Tables should be surrounded by blank lines : https://github.com/DavidAnson/markdownlint/blob/v0.39.0/doc/md058.md
+MD058: true
+# MD059/descriptive-link-text : Link text should be descriptive : https://github.com/DavidAnson/markdownlint/blob/v0.39.0/doc/md059.md
+MD059:
+  # Prohibited link texts
+  prohibited_texts:
+    - click here
+    - here
+    - link
+    - more
+# MD060/table-column-style : Table column style : https://github.com/DavidAnson/markdownlint/blob/v0.39.0/doc/md060.md
+MD060: false

.pre-commit-config.yaml

@@ -39,7 +39,7 @@ repos:
   - repo: https://github.com/igorshubovych/markdownlint-cli
     rev: v0.46.0
     hooks:
-      - id: markdownlint
+      - id: markdownlint-fix
   - repo: https://github.com/asottile/add-trailing-comma
     rev: v4.0.0
     hooks:

.vscode/settings.json

@@ -55,10 +55,7 @@
     "files.trimTrailingWhitespace": false,
     "editor.defaultFormatter": "DavidAnson.vscode-markdownlint"
   },
-  "markdownlint.config": {
-    "extends": ".markdownlint.yaml"
-  },
-  "markdownlint.run": "onType",
+  "markdownlint.configFile": ".markdownlint.yaml",
   "[json]": {
     "editor.defaultFormatter": "vscode.json-language-features"
   },

AGENTS.md

@@ -98,6 +98,13 @@ uv run docs build           # Build site
 uv run docs deploy          # Deploy to GitHub Pages
 ```
 
+**Configuration:**
+
+```bash
+uv run config generate      # Generate configuration example files
+uv run config validate      # Validate the current configuration
+```
+
 ## Development Workflow
 
 1. **Setup:** `uv sync` → configure `.env` & `config.toml`

README.md

@@ -58,7 +58,6 @@ It is designed to provide a variety of features to the server, including moderat
   - [Prerequisites](#prerequisites)
   - [Setup & Workflow](#setup--workflow)
 - [Documentation & Support](#documentation--support)
-- [Quick Commands](#quick-commands)
 - [License](#license)
 - [Metrics](#metrics)
 - [Contributors](#contributors)
@@ -188,49 +187,6 @@ Modular plugin architecture for extending functionality without modifying core c
 
 <sub>[back to top ↑](#table-of-contents)</sub>
 
-## Quick Commands
-
-| Category | Command | Description |
-|----------|---------|-------------|
-| **Bot** | `uv run tux start` | Start the Tux Discord bot |
-| | `uv run tux version` | Show Tux version information |
-| **Development** | `uv run dev lint` | Run linting with Ruff |
-| | `uv run dev lint-fix` | Run linting with Ruff and apply fixes |
-| | `uv run dev format` | Format code with Ruff |
-| | `uv run dev type-check` | Check types with basedpyright |
-| | `uv run dev lint-docstring` | Lint docstrings with pydoclint |
-| | `uv run dev docstring-coverage` | Check docstring coverage |
-| | `uv run dev pre-commit` | Run pre-commit checks |
-| | `uv run dev all` | Run all development checks |
-| **Testing** | `uv run tests all` | Run all tests with coverage and enhanced output |
-| | `uv run tests quick` | Run tests without coverage (faster) |
-| | `uv run tests plain` | Run tests with plain output |
-| | `uv run tests parallel` | Run tests in parallel |
-| | `uv run tests html` | Run tests and generate HTML report |
-| | `uv run tests coverage` | Generate comprehensive coverage reports |
-| | `uv run tests benchmark` | Run benchmark tests |
-| **Database** | `uv run db init` | Initialize database with proper migrations |
-| | `uv run db dev` | Development workflow: generate migration and apply it |
-| | `uv run db push` | Apply all pending migrations to database |
-| | `uv run db status` | Show current migration status |
-| | `uv run db new "message"` | Generate new migration from model changes |
-| | `uv run db health` | Check database connection health |
-| | `uv run db schema` | Validate database schema matches models |
-| | `uv run db queries` | Check for long-running queries |
-| **Docker** | `uv run docker up` | Start Docker services with smart orchestration |
-| | `uv run docker down` | Stop Docker services |
-| | `uv run docker build` | Build Docker images |
-| | `uv run docker logs` | Show Docker service logs |
-| | `uv run docker ps` | List running Docker containers |
-| | `uv run docker shell` | Open shell in container |
-| | `uv run docker health` | Check container health status |
-| | `uv run docker config` | Validate Docker Compose configuration |
-| **Documentation** | `uv run docs serve` | Start local documentation server |
-| | `uv run docs build` | Build documentation site |
-| **Configuration** | `uv run config generate` | Generate example configuration files |
-
-<sub>[back to top ↑](#table-of-contents)</sub>
-
 ## License
 
 Tux is free and open source software licensed under the [GNU General Public License v3.0](LICENSE), founded by [@kzndotsh](https://github.com/kzndotsh), created for and maintained by the [All Things Linux](https://allthingslinux.org) community.