Expand help.md to all meza commands

Author: freephile

manual/meza-cmd/MIGRATION.md

@@ -23,19 +23,19 @@ def display_docs(name):
     """
     Display the contents of a help file with the given name.
     Prefers Markdown (.md) files over text (.txt) files.
-    
+
     Notes:
         - Prioritizes .md files over .txt files for enhanced formatting
         - Provides fallback to legacy .txt files if .md files don't exist
         - Shows helpful update instructions if no help file is found
         - Guides users to update their project sources for latest documentation
     """
     import os
-    
+
     # Try .md file first, fallback to .txt
     md_file = f'/opt/meza/manual/meza-cmd/{name}.md'
     txt_file = f'/opt/meza/manual/meza-cmd/{name}.txt'
-    
+
     if os.path.exists(md_file):
         with open(md_file, encoding='utf-8') as f:
             print(f.read())
@@ -49,7 +49,7 @@ def display_docs(name):
         print("Please update your project sources to get the latest help documentation:")
         print("")
         print("  git pull origin main")
-        print("  # or")  
+        print("  # or")
         print("  git pull origin dev")
         print("")
         print("For a complete list of available commands, try:")
@@ -139,7 +139,7 @@ All help commands now display rich Markdown formatting:
 # All commands show enhanced Markdown help
 meza create --help     # Wiki creation with detailed examples
 meza delete --help     # Deletion with safety warnings and emojis
-meza deploy --help     # Deployment options and workflows  
+meza deploy --help     # Deployment options and workflows
 meza backup --help     # Backup operations with visual indicators
 meza setup --help      # Environment setup instructions
 meza deploy --help     # Deployment directives and requirements
@@ -157,8 +157,8 @@ meza migrate-wikis --help  # Wiki migration workflows
 
 ## Migration Results
 
-**Before migration**: 16 `.txt` files, 0 `.md` files  
-**After migration**: 16 `.txt` files, 16 `.md` files  
+**Before migration**: 16 `.txt` files, 0 `.md` files
+**After migration**: 16 `.txt` files, 16 `.md` files
 **After cleanup**: 0 `.txt` files, 16 `.md` files (pending deletion)
 
 ### Files Ready for Deletion
@@ -197,4 +197,4 @@ All help commands have been thoroughly tested and verified:
 
 🎉 **The migration is now complete and ready for production use!**
 
-All legitimate user commands have been migrated to Markdown with enhanced documentation, improved formatting, and better user experience. The `.txt` files can be safely deleted from the repository.
+All legitimate user commands have been migrated to Markdown with enhanced documentation, improved formatting, and better user experience. The `.txt` files can be safely deleted from the repository.

manual/meza-cmd/help.md

@@ -8,50 +8,124 @@
 meza COMMAND [directives]
 ```
 
-## Quick Multi-Server Setup
+## Quick Start
 
-To set up a multi-server environment:
+### Single Machine Development Setup
+```bash
+# Deploy monolith environment (creates 'demo' wiki automatically)
+meza deploy monolith
+
+# Create additional wikis
+meza create wiki monolith
+```
 
+### Multi-Server Production Setup
 ```bash
 # 1. Setup the environment (follow prompts)
-meza setup env
+meza setup env production
 
 # 2. Edit configuration files as required:
-sudo vi /opt/conf-meza/secret/<env-name>/hosts
-sudo vi /opt/conf-meza/secret/<env-name>/secret.yml
+sudo vi /opt/conf-meza/secret/production/hosts
+sudo vi /opt/conf-meza/secret/production/secret.yml
 
 # 3. Deploy the environment
-sudo meza deploy <env-name>
+sudo meza deploy production
+
+# 4. Monitor deployment progress
+meza deploy-tail production
+```
+
+### Common Management Tasks
+```bash
+# List existing wikis
+meza list-wikis monolith
+
+# Backup before changes
+meza backup monolith
+
+# Run maintenance jobs
+meza maint run-jobs monolith
+
+# Check deployment status
+meza deploy-check production
 ```
 
 ## Command Reference
 
+### Environment Management
 | Command | Directives | Description |
 |---------|------------|-------------|
-| **deploy** | `<environment>` | Deploy your server (e.g. `monolith`) |
-| **setup** | `env` | Setup an environment |
-| | `dev` | Setup dev features (Git, FTP) |
-| **create** | `wiki` | Create a wiki |
-| | `wiki-promptless` | Create a wiki without prompts |
-| **backup** | `<environment>` | Create a backup of an environment |
-| **docker** | `run` | 🧪 (experimental) Start container |
+| **setup** | `env` | Setup a new environment |
+| | `dev` | Setup development tools (Git, FTP) |
+| | `dev-networking` | Configure VirtualBox VM networking |
+| | `docker` | Install Docker (CentOS only) |
+| **deploy** | `<environment>` | Deploy MediaWiki to environment |
+| **update** | `[version]` | Update Meza to version or branch |
+
+### Wiki Operations  
+| Command | Directives | Description |
+|---------|------------|-------------|
+| **create** | `wiki` | Create a new wiki (interactive) |
+| | `wiki-promptless` | Create wiki without prompts |
+| **delete** | `wiki` | Delete a wiki (interactive) |
+| | `wiki-promptless` | Delete wiki without prompts |
+| | `elasticsearch` | Delete Elasticsearch data |
+| **list-wikis** | `<environment>` | List all wikis in environment |
+
+### Maintenance & Backup
+| Command | Directives | Description |
+|---------|------------|-------------|
+| **backup** | `<environment>` | Create environment backup |
+| **push-backup** | `<environment>` | Push backup to remote location |
+| **maint** | `run-jobs` | Run MediaWiki job queue |
+| | `rebuild` | Rebuild search index and SMW |
+| | `cleanuploadstash` | Clean upload stash |
+| | `encrypt-string` | Encrypt sensitive data |
+| | `decrypt-string` | Decrypt data |
+
+### Deployment Management
+| Command | Directives | Description |
+|---------|------------|-------------|
+| **deploy-check** | `<environment>` | Check if environment is deploying |
+| **deploy-lock** | `<environment>` | Lock environment for deployment |
+| **deploy-unlock** | `<environment>` | Remove deployment lock |
+| **deploy-kill** | `<environment>` | Kill deployment and remove lock |
+| **deploy-log** | `<environment>` | Get deployment log file path |
+| **deploy-tail** | `<environment>` | Follow deployment logs real-time |
+
+### Development & Debug
+| Command | Directives | Description |
+|---------|------------|-------------|
+| **debug** | `<environment> [variable]` | Debug Ansible variables |
+| **docker** | `run` | 🧪 Start development container |
 | | `exec` | Execute command on container |
+| **migrate-wikis** | `<environment>` | Migrate wiki IDs to declarative YAML |
 
 ## Getting Help
 
 Every command has directives. If you run any command without directives, it will provide help for that command.
 
 ```bash
-# Get help for specific commands
+# Get help for main commands
 meza deploy --help
 meza setup --help
 meza create --help
+meza maint --help
+
+# Get help for deployment management
+meza deploy-check --help
+meza deploy-tail --help
+
+# Run commands without arguments for specific help
+meza backup
+meza debug
+meza delete
 ```
 
 ## Architecture Overview
 
 - **Environment**: Complete MediaWiki deployment (production, development, etc.)
-- **Wiki**: Individual wiki within an environment  
+- **Wiki**: Individual wiki within an environment
 - **Monolith**: Single-server environment (ideal for development)
 - **Multi-server**: Distributed deployment across multiple servers
 
@@ -65,4 +139,4 @@ meza create --help
 
 - [Complete Command Index](index.md) - Detailed documentation for all commands
 - [Installation Guide](install.md) - Get started with Meza
-- [Setup Guide](setup.md) - Environment configuration
+- [Setup Guide](setup.md) - Environment configuration

manual/meza-cmd/install.md

@@ -70,4 +70,4 @@ meza create wiki monolith mywiki "My Wiki"
 
 - [`meza deploy`](deploy.md) - Deploy environments
 - [`meza setup`](setup.md) - Set up system components
-- [`meza create`](create.md) - Create wikis after deployment
+- [`meza create`](create.md) - Create wikis after deployment