Added Zola-Based Documentation Site

[bradpenney]

Summary

This PR introduces a full featured documentation site for the Firestone project, built using Zola (https://www.getzola.org/). It covers everything from installation and quick starts to advanced configuration and deep dives into the resource schema.

Key Changes

• New Documentation Site Structure: Added a complete Zola project in docs/site/ including configuration, templates, themes, and static assets.
• Extensive Content:
  • Getting Started: Architecture, Installation, Quickstart, and "Why Resource First" guides.
  • Core Concepts: Detailed breakdown of Resource Types, Anatomy, and a comprehensive Resource Schema reference.
  • Generation Guides: Specific guides for generating AsyncAPI, CLI, OpenAPI, and Streamlit artifacts.
  • Advanced Topics: Articles on API design principles, authentication, security, schema design, and Docker integration.
  • Examples: Walkthroughs for Addressbook, Blog API, and Simple CRUD examples.
  • Reference: CLI command reference, cheat sheets, and error message guides.
• CI/CD: Added .github/workflows/docs.yaml to automate the documentation build process.
• Tooling: Included helper scripts (add_frontmatter.sh, fix_anchors.py, test-docs.sh) to maintain documentation quality.
• Dependencies: Updated pyproject.toml and poetry.lock to support documentation needs.

Motivation

To provide users and developers with a single, searchable, and comprehensive source of truth for using Firestone, replacing scattered READMEs with structured documentation.

Signed-off-by: Brad Penney penney.brad@protonmail.com

Signed-off-by: Brad Penney penney.brad@protonmail.com

[dgunzy]

Look good!

[ebourgeois]

Not needed, no?

[ebourgeois]

Need to remove