docs: add comprehensive CLI documentation

[joshrotenberg]

Summary

This PR adds comprehensive CLI reference documentation for redisctl, integrates it into the mdBook documentation structure, and sets up automated deployment to GitHub Pages.

Changes

Documentation Added

• 46 CLI command reference files covering all commands:

  • Profile commands (list, get, set, remove, default)
  • Smart routing commands (database, user, cluster, account)
  • Cloud commands (19 subcommands including api, subscription, database, backup, acl, etc.)
  • Enterprise commands (14 subcommands including api, bootstrap, cluster, database, etc.)

• Detailed examples guide (docs/src/cli/examples-detailed.md) with real-world usage scenarios

mdBook Integration

• All CLI reference documentation moved to docs/src/cli-reference/ for proper mdBook structure
• Added comprehensive "CLI Command Reference" section to docs/src/SUMMARY.md
• Integrated detailed examples into the "CLI Usage" section
• Updated book.toml with correct repository URLs and title
• Successfully tested with mdbook build

GitHub Pages Deployment

• New workflow (.github/workflows/mdbook.yml) for automatic deployment
• mdbook-lint integration for documentation quality checks (informational mode)
• Builds on all PRs for validation
• Deploys to GitHub Pages on pushes to main branch
• Caches mdbook-lint installation for faster CI

Documentation Generation

• Created automated script (scripts/generate-cli-docs.sh) for future documentation updates
• Script extracts help text directly from the CLI for accuracy

Documentation Structure

docs/src/
├── cli/
│   └── examples-detailed.md      # Comprehensive examples
├── cli-reference/
│   ├── index.md                  # Overview
│   ├── profile/                  # Profile management commands
│   ├── smart/                    # Smart routing commands
│   ├── cloud/                    # Cloud-specific commands
│   └── enterprise/               # Enterprise-specific commands

Testing

• mdBook builds successfully
• All links in SUMMARY.md are valid
• Documentation renders correctly in mdBook
• GitHub Actions workflow syntax validated
• Link fragments fixed for proper navigation

GitHub Pages Setup

Once merged, the documentation will be automatically deployed to GitHub Pages:

1. Go to Settings → Pages
2. Set Source to "GitHub Actions"
3. Documentation will be available at https://joshrotenberg.github.io/redisctl/

Local Development

# Install mdBook (if not already installed)
cargo install mdbook

# View documentation locally
cd docs
mdbook serve

# Build documentation
cd docs
mdbook build

# Run linting (optional, informational only)
cargo install mdbook-lint
mdbook-lint lint docs/src --config-format=disabled

Related Issues

Addresses #34 - CLI documentation

Next Steps

• Merge PR to trigger initial GitHub Pages deployment
• Configure repository settings for GitHub Pages
• Documentation will be automatically updated on future pushes to main