Changelog

Changelog

All notable changes to the A is for Agent website.

[Unreleased] - 2025-10-11

Added

Core Files

  • README.md: Comprehensive project documentation with setup instructions, deployment guide, and troubleshooting
  • CONTRIBUTING.md: Detailed contribution guidelines, style guide, and PR process
  • LICENSE: MIT License for the project
  • .gitignore: Proper exclusions for Jekyll, Ruby, macOS, Windows, Linux, and editor files
  • CHANGELOG.md: This file to track changes

Content Collections

  • _blueprints/ directory with sample content:
    • kafka-streaming-pipeline.md: Architecture blueprint for Kafka streaming
  • _playbooks/ directory with sample content:
    • incident-response.md: Operational playbook for incident response
  • _workflows/ directory enhancements:
    • kafka-to-scylla-ingest.md: Real-time data ingestion workflow

Blog Posts

  • 2025-10-11-introducing-a-platform.md: Launch announcement blog post

Project Documentation

  • .project-docs/ directory for internal content guidelines:
    • README.md: Documentation about the project docs folder
    • docs-intent.md: Guidelines for documentation content
    • portal-intent.md: Guidelines for portal content
    • workflows-intent.md: Guidelines for workflow content

Assets

  • architecture-diagram.svg: Platform architecture visualization
  • og-default.png: Default Open Graph image for social media sharing

Enhanced

Configuration

  • _config.yml:
    • Set production URL to https://www.aisforagent.net
    • Configured Google Analytics ID: G-VRQVFBMT94
    • Set timezone to Australia/Perth
    • Added explanatory comments for theme configuration

Layouts

  • _layouts/base.html:
    • Added comprehensive SEO meta tags
    • Added Open Graph and Twitter Card metadata
    • Integrated Google Analytics tracking
    • Added accessibility features (skip-to-content link, ARIA labels, semantic HTML)
    • Added proper role attributes for semantic sections

Styles

  • assets/css/main.css:
    • Added styles for skip-to-content link
    • Enhanced accessibility with focus states

JavaScript

  • assets/js/auth.js:
    • Added comprehensive error handling
    • Added 5-second timeout for authentication checks
    • Improved code documentation
    • Added better fallback behavior
    • Use strict mode for better code quality

Pages

  • pages/features.md: Expanded from bullet points to comprehensive feature showcase with:
    • Detailed feature descriptions
    • Use cases
    • Getting started guide
    • Coming soon section
  • pages/downloads.md: Enhanced with:
    • Detailed download instructions
    • System requirements
    • SDK and CLI information
    • Links to quickstarts and examples
    • Release notes section
  • pages/blog.md: Transformed from stub to functional blog index with:
    • Dynamic post listing
    • Post metadata display
    • Category chips
    • Responsive styling

Portal Pages

  • portal/index.md: Enhanced dashboard with:
    • Clear section organization
    • Quick actions
    • Recent activity placeholder
    • Support links
  • portal/premium.md: Expanded premium services page with:
    • Detailed feature descriptions
    • Pricing tiers
    • Use cases
    • FAQ section
    • Billing management section

Content

  • index.md: Updated to use new architecture diagram instead of placeholder

Removed

  • staticwebapp.config.json: Removed broken /rfcs/* route

Moved

  • Moved docs/intent.md → .project-docs/docs-intent.md
  • Moved portal/intent.md → .project-docs/portal-intent.md
  • Moved workflows/intent.md → .project-docs/workflows-intent.md

Fixed

  • Missing collection directories that were referenced in configuration
  • Broken route configurations
  • Missing SEO metadata
  • Accessibility issues in navigation
  • Placeholder content

Project Structure

The project now has the following complete structure:

aWebsite/
├── .gitignore
├── .project-docs/          # Internal documentation
├── _config.yml
├── _data/
├── _docs/
├── _includes/
├── _layouts/
├── _posts/
├── _workflows/             # ✨ Enhanced
├── _blueprints/            # ✨ New
├── _playbooks/             # ✨ New
├── assets/
│   ├── css/
│   ├── js/                # ✨ Enhanced
│   └── img/               # ✨ New diagrams
├── pages/                 # ✨ Enhanced
├── portal/                # ✨ Enhanced
├── CHANGELOG.md           # ✨ New
├── CONTRIBUTING.md        # ✨ New
├── Gemfile
├── index.md
├── LICENSE                # ✨ New
├── README.md              # ✨ New
└── staticwebapp.config.json

Notes

All changes maintain compatibility with Jekyll and Azure Static Web Apps. The site is now production-ready with:

  • Complete SEO optimization
  • Accessibility compliance
  • Analytics integration
  • Comprehensive documentation
  • Sample content for all collections
  • Professional layout and design