Complete Documentation Overhaul: Comprehensive User Guides, API Reference, and Community Resources (#64)

## 📚 Major Documentation Restructure

This pull request completely transforms STRUCT's documentation from a
single monolithic README to a comprehensive, organized documentation
system that provides better user experience and easier navigation.

## 🔄 What Changed

### Documentation Architecture
- **Removed**: Single-file Spanish README (`README.es.md`) and legacy
HTML documentation
- **Restructured**: Main `README.md` streamlined to focus on quick start
and navigation
- **Added**: Comprehensive modular documentation system with 16+
specialized guides

### New Documentation Structure

#### 🏁 Getting Started
- **[Installation Guide](docs/installation.md)** - Multiple installation
methods (pip, Docker, source)
- **[Quick Start](docs/quickstart.md)** - Get up and running in minutes
with practical examples
- **[Basic Usage](docs/usage.md)** - Core commands and CLI reference

#### ⚙️ Configuration & Features
- **[YAML Configuration](docs/configuration.md)** - Complete
configuration reference with examples
- **[Template Variables](docs/template-variables.md)** - Dynamic content
with Jinja2 templating
- **[File Handling](docs/file-handling.md)** - File permissions, remote
content, handling strategies
- **[Schema Reference](docs/schema.md)** - YAML validation and IDE
support setup

#### 🔧 Advanced Features
- **[Hooks](docs/hooks.md)** - Pre/post-generation automation with
practical examples
- **[Mappings](docs/mappings.md)** - External data integration and
environment-specific configs
- **[GitHub Integration](docs/github-integration.md)** - Automation with
GitHub Actions and workflows
- **[Command-Line Completion](docs/completion.md)** - Enhanced CLI
experience setup

#### 👩‍💻 Development & Community
- **[Development Setup](docs/development.md)** - Complete contributor
guide with setup instructions
- **[Contributing Guidelines](docs/contributing.md)** - Comprehensive
contribution workflow and standards
- **[Known Issues](docs/known-issues.md)** - Current limitations,
workarounds, and troubleshooting
- **[Examples](docs/examples/)** - Practical examples directory with
index

#### 📖 Resources & Support
- **[Articles & Tutorials](docs/articles.md)** - Community content and
external resources
- **[Funding](docs/funding.md)** - Support options and sponsorship
information

### Main README Improvements
- **Streamlined focus** on key features and quick navigation
- **Better organization** with clear sections and call-to-action links
- **Professional presentation** with consistent formatting and structure
- **Comprehensive linking** to detailed documentation sections

### Content Migration & Enhancement
- **Preserved all existing content** while improving organization and
readability
- **Enhanced examples** with more practical, real-world scenarios
- **Added troubleshooting sections** and best practices throughout
- **Improved cross-referencing** between related topics

## 🎯 Benefits

### For New Users
- **Faster onboarding** with dedicated quick start guide
- **Clear learning path** from basic to advanced concepts
- **Better examples** that show real-world usage patterns

### For Existing Users
- **Easy reference** with topic-specific documentation
- **Advanced guides** for complex scenarios
- **Troubleshooting resources** for common issues

### For Contributors
- **Clear contribution guidelines** with setup instructions
- **Development workflow** documentation
- **Issue reporting templates** and best practices

### For Maintainers
- **Modular structure** easier to maintain and update
- **Community resources** to reduce support burden
- **Professional presentation** for project credibility

## 📁 File Changes Summary

### Removed Files (Legacy Documentation)
- `README.es.md` (502 lines) - Spanish documentation consolidated
- `docs/index.html` (59 lines) - Legacy HTML documentation
- `docs/css/style.css` (73 lines) - HTML styling no longer needed
- `docs/js/script.js` (3 lines) - JavaScript no longer needed

### Major Updates
- `README.md` - Completely restructured (497 lines reduced, 70 lines
added)
- Added comprehensive documentation index at `docs/index.md`

### New Documentation Files (2,000+ lines total)
- Configuration guides (423 lines across multiple files)
- Advanced feature documentation (847 lines)
- Development and community guides (693 lines)
- Reference materials and examples (350+ lines)

## 🔗 Navigation & Accessibility

- **Central index** at `docs/index.md` with organized sections
- **Cross-references** between related topics
- **Consistent formatting** and structure across all files
- **Table of contents** in larger documents
- **Progressive disclosure** from basic to advanced topics

This documentation overhaul positions STRUCT as a professional,
well-documented tool that's accessible to users of all skill levels
while providing comprehensive resources for advanced usage and
contribution.

Author: httpdss

.github/workflows/labeler.yaml

@@ -7,6 +7,9 @@ jobs:
     permissions:
       contents: read
       pull-requests: write
+      issues: write
     runs-on: ubuntu-latest
     steps:
       - uses: actions/labeler@v5.0.0
+        with:
+          configuration-path: .github/labeler.yml