Add comprehensive documentation for STRUCT

- Introduced GitHub integration documentation for automating project structures across repositories.
- Added hooks documentation to define pre and post-generation commands.
- Removed outdated index.html and replaced it with a new index.md for better navigation.
- Created installation guide for easy setup of STRUCT.
- Added known issues documentation to track limitations and workarounds.
- Introduced mappings support documentation for injecting key-value pairs into templates.
- Added quick start guide for rapid deployment using Docker.
- Created YAML schema reference for validation and IDE support.
- Added template variables documentation for dynamic content generation.
- Documented basic usage of STRUCT commands and options.

Author: httpdss

README.es.md

@@ -0,0 +1,186 @@
+# Articles and Resources
+
+Collection of articles, tutorials, and external resources about STRUCT.
+
+## Official Articles
+
+### [Defining User Prompts on STRUCT: Harnessing GPT-4.1 for Scalable Project Scaffolding](https://medium.com/@httpdss/defining-user-prompts-on-struct-harnessing-gpt-4-1-for-scalable-project-scaffolding-e6d3b4ec4701)
+
+Learn how to leverage GPT-4.1 to create intelligent project scaffolding with STRUCT. This article covers advanced prompting techniques and AI-driven project generation.
+
+**Topics covered:**
+
+- AI-powered template generation
+- Dynamic project structures
+- GPT-4.1 integration patterns
+- Scalable scaffolding strategies
+
+### [Unlocking Developer Productivity with STRUCT: The Ultimate Open-Source Tool for Automated Project Structures](https://blog.devops.dev/unlocking-developer-productivity-with-struct-the-ultimate-open-source-tool-for-automated-project-8bca9b5f40f9)
+
+A comprehensive overview of STRUCT's capabilities and how it can boost developer productivity through automation.
+
+**Topics covered:**
+
+- Project structure automation
+- Developer workflow optimization
+- Open-source benefits
+- Real-world use cases
+
+### [Automating Project Structures with STRUCT and GitHub Actions](https://medium.com/@httpdss/automating-project-structures-with-struct-and-github-actions-64e09c40c11e)
+
+Discover how to integrate STRUCT with GitHub Actions for automated project setup and maintenance across repositories.
+
+**Topics covered:**
+
+- GitHub Actions integration
+- CI/CD automation
+- Repository management
+- Workflow triggers
+
+### [Advanced STRUCT Tips: Working with Template Variables and Jinja2 Filters](https://medium.com/@httpdss/advanced-struct-tips-working-with-template-variables-and-jinja2-filters-b239bf3145e4)
+
+Deep dive into STRUCT's templating system, covering advanced variable usage and custom Jinja2 filters.
+
+**Topics covered:**
+
+- Template variable patterns
+- Custom Jinja2 filters
+- Dynamic content generation
+- Advanced templating techniques
+
+## Community Articles
+
+*Community contributions welcome! Submit a PR to add your STRUCT-related articles here.*
+
+## Tutorials
+
+### Video Tutorials
+
+*Coming soon - video tutorials will be added as they become available.*
+
+### Interactive Tutorials
+
+- **Getting Started Guide**: Follow along with practical examples in the [Quick Start](quickstart.md) documentation
+- **Template Variables**: Learn by example in the [Template Variables](template-variables.md) guide
+- **Advanced Configuration**: Explore complex scenarios in [YAML Configuration](configuration.md)
+
+## Use Cases
+
+### DevOps and Infrastructure
+
+- **Terraform Module Generation**: Standardize infrastructure code
+- **Kubernetes Manifests**: Generate consistent deployment configurations
+- **CI/CD Pipeline Templates**: Automate pipeline creation
+- **Configuration Management**: Maintain consistent environments
+
+### Application Development
+
+- **Microservice Scaffolding**: Generate service boilerplate
+- **API Project Templates**: Standardize REST API structures
+- **Frontend Framework Setup**: Bootstrap React, Vue, or Angular projects
+- **Database Schema Generation**: Create consistent database structures
+
+### Documentation and Compliance
+
+- **Project Documentation**: Generate README templates and docs
+- **Compliance Templates**: Ensure regulatory requirements
+- **Security Configurations**: Apply security best practices
+- **Audit Trail Generation**: Create trackable project structures
+
+## Presentations and Talks
+
+*Conference presentations and community talks about STRUCT will be listed here.*
+
+## Research and Academic Papers
+
+*Academic research involving STRUCT or related concepts will be referenced here.*
+
+## External Tools and Integrations
+
+### IDE Extensions
+
+- **VS Code YAML Extension**: Enhanced editing with schema validation
+- **IntelliJ YAML Support**: Schema-aware editing and completion
+
+### CI/CD Integrations
+
+- **GitHub Actions**: Pre-built actions for STRUCT workflows
+- **GitLab CI**: Integration examples and templates
+- **Jenkins**: Pipeline integration patterns
+
+### Complementary Tools
+
+- **Cookiecutter**: Alternative project templating tool
+- **Yeoman**: JavaScript-focused scaffolding
+- **Copilot**: AI-powered code generation
+- **Terraform**: Infrastructure as code
+
+## Community Resources
+
+### Forums and Discussion
+
+- **GitHub Discussions**: Official community forum
+- **Stack Overflow**: Questions tagged with `struct-tool`
+- **Reddit**: `/r/devops` and `/r/python` communities
+
+### Code Examples
+
+- **GitHub Examples Repository**: Community-contributed examples
+- **Gist Collections**: Snippets and configurations
+- **Docker Hub**: Pre-built images and examples
+
+## Learning Paths
+
+### Beginner Path
+
+1. Start with [Installation](installation.md)
+2. Follow the [Quick Start](quickstart.md) guide
+3. Explore [Basic Usage](usage.md)
+4. Learn [YAML Configuration](configuration.md) basics
+
+### Intermediate Path
+
+1. Master [Template Variables](template-variables.md)
+2. Understand [File Handling](file-handling.md) strategies
+3. Explore [Custom Structures](custom-structures.md)
+4. Learn [Mappings](mappings.md) for data separation
+
+### Advanced Path
+
+1. Implement [Hooks](hooks.md) for automation
+2. Set up [GitHub Integration](github-integration.md)
+3. Contribute to [Development](development.md)
+4. Create complex multi-environment setups
+
+## Contributing Content
+
+We welcome contributions to this resource collection! Here's how you can help:
+
+### Adding Articles
+
+1. Fork the repository
+2. Add your article to the appropriate section
+3. Include a brief description and key topics
+4. Submit a pull request
+
+### Suggesting Resources
+
+- Open an issue with the "resource suggestion" label
+- Include the resource link and description
+- Explain why it would be valuable to the community
+
+### Writing Tutorials
+
+- Create step-by-step guides with practical examples
+- Include code snippets and expected outputs
+- Test instructions thoroughly before submitting
+
+## Newsletter and Updates
+
+Stay updated with the latest STRUCT developments:
+
+- **GitHub Releases**: Watch the repository for release notifications
+- **Community Updates**: Follow project maintainers on social media
+- **Blog Subscriptions**: Subscribe to the official blog for updates
+
+*This page is regularly updated with new content. Bookmark it for future reference!*

README.md

@@ -0,0 +1,211 @@
+# Command-Line Auto-Completion
+
+This project uses [argcomplete](https://kislyuk.github.io/argcomplete/) to provide command-line auto-completion for the `struct` script. Follow these steps to enable auto-completion:
+
+## Installation
+
+### 1. Install argcomplete
+
+```sh
+pip install argcomplete
+```
+
+### 2. Enable Global Completion
+
+This step is usually done once per system:
+
+```sh
+activate-global-python-argcomplete
+```
+
+This command sets up global completion for all Python scripts that use argcomplete.
+
+### 3. Register the Script
+
+Add the following line to your shell's configuration file:
+
+**For Bash** (`.bashrc` or `.bash_profile`):
+
+```sh
+eval "$(register-python-argcomplete struct)"
+```
+
+**For Zsh** (`.zshrc`):
+
+```sh
+eval "$(register-python-argcomplete struct)"
+```
+
+**For Fish** (`.config/fish/config.fish`):
+
+```fish
+register-python-argcomplete --shell fish struct | source
+```
+
+### 4. Reload Your Shell
+
+```sh
+# For Bash
+source ~/.bashrc
+
+# For Zsh
+source ~/.zshrc
+
+# For Fish
+source ~/.config/fish/config.fish
+```
+
+## Usage
+
+After completing the setup, you can use auto-completion by typing part of a command and pressing `Tab`:
+
+```sh
+struct <Tab>
+# Shows: generate, generate-schema, validate, info, list
+
+struct generate <Tab>
+# Shows available structure names and options
+
+struct generate --<Tab>
+# Shows: --log, --dry-run, --backup, --file-strategy, etc.
+```
+
+## Advanced Configuration
+
+### Per-Project Completion
+
+If you only want completion for specific projects, you can add completion to your project's virtual environment activation script:
+
+```sh
+# In your .venv/bin/activate file, add:
+eval "$(register-python-argcomplete struct)"
+```
+
+### Custom Completion
+
+You can create custom completion functions for specific use cases:
+
+```sh
+# Custom completion for structure names
+_struct_structures() {
+    local structures=$(struct list --names-only 2>/dev/null)
+    COMPREPLY=($(compgen -W "$structures" -- "${COMP_WORDS[COMP_CWORD]}"))
+}
+
+# Register custom completion
+complete -F _struct_structures struct-generate
+```
+
+## Troubleshooting
+
+### Completion Not Working
+
+1. **Check argcomplete installation**:
+
+   ```sh
+   python -c "import argcomplete; print('OK')"
+   ```
+
+2. **Verify global activation**:
+
+   ```sh
+   activate-global-python-argcomplete --user
+   ```
+
+3. **Check shell configuration**:
+   Make sure the eval statement is in the correct shell configuration file.
+
+4. **Restart your shell**:
+   Sometimes you need to completely restart your terminal.
+
+### Slow Completion
+
+If completion is slow, you can enable caching:
+
+```sh
+export ARGCOMPLETE_USE_TEMPFILES=1
+```
+
+Add this to your shell configuration file for persistent caching.
+
+### Debug Completion
+
+Enable debug mode to troubleshoot completion issues:
+
+```sh
+export _ARGCOMPLETE_DEBUG=1
+struct <Tab>
+```
+
+## Platform-Specific Notes
+
+### macOS
+
+On macOS, you might need to install bash-completion first:
+
+```sh
+# Using Homebrew
+brew install bash-completion
+
+# Then add to ~/.bash_profile:
+[[ -r "/usr/local/etc/profile.d/bash_completion.sh" ]] && . "/usr/local/etc/profile.d/bash_completion.sh"
+```
+
+### Windows
+
+For Windows users using Git Bash or WSL, follow the same steps as Linux. For PowerShell, argcomplete support is limited.
+
+### Docker
+
+When running STRUCT in Docker, completion won't work directly. However, you can create a wrapper script:
+
+```sh
+#!/bin/bash
+# struct-wrapper.sh
+docker run --rm -v $(pwd):/workdir ghcr.io/httpdss/struct:main "$@"
+```
+
+Then set up completion for the wrapper:
+
+```sh
+eval "$(register-python-argcomplete struct-wrapper.sh)"
+```
+
+## Benefits of Auto-Completion
+
+- **Faster typing**: Quickly complete command names and options
+- **Discoverability**: See available commands and options
+- **Accuracy**: Reduce typos and errors
+- **Productivity**: Spend less time looking up command syntax
+
+## Supported Completions
+
+STRUCT provides completion for:
+
+- **Commands**: `generate`, `validate`, `list`, etc.
+- **Options**: `--log`, `--dry-run`, `--backup`, etc.
+- **Structure names**: All available built-in and custom structures
+- **File paths**: Local files and directories
+- **Enum values**: Log levels, file strategies, etc.
+
+## Example Session
+
+```sh
+$ struct <Tab>
+generate        generate-schema info           list           validate
+
+$ struct generate <Tab>
+configs/        docker-files    project/       terraform/
+
+$ struct generate terraform/<Tab>
+terraform/app   terraform/module
+
+$ struct generate --<Tab>
+--backup        --dry-run       --file-strategy --log
+--log-file      --mappings-file --structures-path
+
+$ struct generate --log <Tab>
+DEBUG    ERROR    INFO     WARNING
+```
+
+This makes working with STRUCT much more efficient and user-friendly!