Add GitHub Actions workflow for automatic documentation generation and deployment

[Copilot]

This PR implements automatic documentation generation and deployment using GitHub Actions and MkDocs, addressing the requirement to "modificar los workflows para que se genere la documentacion" (modify workflows to generate documentation).

Changes Made

Added .github/workflows/docs.yml that automatically:

• Builds MkDocs documentation on every push to main and pull requests
• Deploys the generated documentation to GitHub Pages when changes are pushed to main
• Uses the existing mkdocs.yml configuration and documentation in /docs/index.md

Workflow Features

• Automated Deployment: Documentation is automatically deployed to https://rafnixg.github.io/bcv-api/ on main branch pushes
• PR Validation: Documentation builds are tested on pull requests to catch issues early
• Modern Actions: Uses latest GitHub Actions versions for security and reliability:
  • actions/checkout@v4
  • actions/setup-python@v5
  • actions/configure-pages@v5
  • actions/upload-pages-artifact@v4
  • actions/deploy-pages@v4
• Efficient Builds: Installs only required MkDocs dependencies for faster execution
• Proper Permissions: Configured with minimal required permissions for GitHub Pages deployment
• Concurrency Control: Prevents conflicting deployments while allowing production deploys to complete

Technical Details

The workflow consists of two jobs:

1. Build: Sets up Python 3.10, installs MkDocs with Material theme, and builds the documentation
2. Deploy: Uploads the built site to GitHub Pages (only on main branch)

The implementation leverages the existing MkDocs setup already present in the repository, requiring no changes to documentation content or configuration files.

Testing

• ✅ Local MkDocs build verified successful
• ✅ Generated site structure validated
• ✅ YAML syntax confirmed valid
• ✅ Complete workflow simulation tested

Once merged, documentation will be automatically available at https://rafnixg.github.io/bcv-api/ and will update automatically with future changes.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.