Skip to content

Release 0.10.0

Choose a tag to compare

View all tags
@cdcavell cdcavell released this 25 Aug 15:35
· 86 commits to main since this release
v0.10.0
d6b7da2
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Release 0.10.0 expands the Learning repository with its first substantial set of Reference Architecture Case Studies, improves documentation discoverability, and refines the DocFX navigation experience.

Highlights

Reference Architecture Case Studies

A new case-study learning area now shows how multiple governance, security, authorization, evidence, and execution boundaries interact inside realistic—but simulated—systems.

This release adds:

  • Governed Administrative Operation

    • follows a fictional account.disable operation
    • separates standing authorization, policy evaluation, acknowledgment, scoped execution authority, and host-owned execution
    • covers policy/resource drift, replay resistance, idempotency, correlated evidence, and partial failure

  • Sensitive-Data Access Decision

    • compares ordinary resource authorization with a governed records.export operation
    • covers tenant boundaries, data classification, purpose and destination approval, acknowledgment, escalation, and short-lived export authority
    • emphasizes data minimization and keeping protected payloads out of governance evidence and operational logs

  • Deployment Approval and Infrastructure Change Gates

    • examines application deployment and infrastructure automation as related but distinct governed workflows
    • distinguishes CI success, human approval, policy decisions, credentials, and execution authority
    • covers plan-versus-apply, environment-specific policy, approval expiry, separation of duties, stale-plan detection, rollback responsibility, and synthetic executors

Across the case studies, the recurring invariant remains:

No valid current decision
        or
No valid scoped execution authority
        ↓
Protected executor is not invoked

Discoverability Improvements

Release 0.10.0 strengthens how published Learning material is found and indexed.

  • Adds automated XML sitemap generation and validation
  • Generates canonical public URLs directly from the built DocFX site
  • Adds source-history-based <lastmod> values
  • Validates representative published pages and sitemap integrity
  • Adds IndexNow support for incremental search-engine notification
  • Publishes and validates the IndexNow verification key
  • Tracks the last successfully deployed revision so notifications reflect actual published changes
  • Keeps external IndexNow failures non-blocking for otherwise successful Pages deployments

Stronger Internal Linking

Standalone problem-oriented articles now connect more naturally into deeper Learning material.

Improvements include:

  • clearer contextual links from articles into tutorials, architecture guidance, samples, labs, and security material
  • reciprocal links where they genuinely help readers
  • contribution guidance for keeping internal linking useful rather than turning it into boilerplate

Standalone Article Backlog

A new problem-oriented article backlog establishes prioritized future publication opportunities based on recognizable practitioner questions rather than project-specific terminology.

The backlog includes:

  • ten candidate standalone articles
  • four initial high-priority topics
  • proposed permanent publication paths
  • supporting Learning material
  • guidance for promoting article ideas into implementation issues

Navigation Improvements

The DocFX top navigation has been simplified using the modern template's native dropdown support.

The previous flat menu is now organized around:

Home

Learn
  Getting Started
  Articles
  Tutorials

Architecture
  Architecture Overview
  Governance
  ASP.NET Core
  Security
  AI Integration

Practice
  Executable Samples
  Labs
  Reference Architecture Case Studies

Advanced

This reduces header crowding while preserving access to all existing Learning areas.

Documentation Fixes

  • Repairs Mermaid sequence diagrams in the governed administrative and sensitive-data case studies
  • Improves case-study publication and metadata validation
  • Extends sitemap and IndexNow coverage to the new case-study section
  • Keeps citation and Zenodo metadata synchronized for the 0.10.0 archival release
Assets 2
Loading