Markdown Comments Demo

AI-Orchestrated Docs. Human-Orchestrated Comments.

Docs live directly in your repository, and comments live as a native layer on top, never locked in third-party SaaS silos. AI agents orchestrate the documentation as code evolves, while humans orchestrate the reviews and discussions on rendered views.

🔑 Instructions to Get Write Access to Leave Comments

Comments on this demo are public to view for everyone. However, to add or reply to comments, GitHub requires repository collaborator access. Complete this 1-click step to get write access, or explore the Instant Zero-Auth Mock Demo with simulated personas and zero GitHub setup:

👉 Request 1-Click Write Access (Join @md-comments/demo-commenters) → Instant automated bot approval • Or try Mock Demo →

Sample Technical Specification

This live document demonstrates how inline comments attach directly to rendered prose. Try highlighting any sentence or inspecting the pre-existing feedback from our reviewers.

Authentication Protocol

All client applications communicate with the backend via mutual TLS and JWT bearer tokens. Tokens expire after 60 minutes and must be refreshed using the /api/v1/auth/refresh endpoint.

Should token lifetime be reduced from 60 minutes to 15 minutes for enhanced security?

Data Storage Architecture

The storage cluster spans across three availability zones with automatic failover enabled:

• Primary read/write node located in us-east-1a
• Synchronous standby node located in us-east-1b
• Asynchronous backup replica located in us-east-1c

export interface ClusterConfig {
  clusterId: string;
  region: 'us-east-1';
  autoFailover: boolean;
  maxReplicationLagMs: number;
}

Deployment Guidelines

All production deployments must follow blue/green rollout procedures. Traffic shifting occurs in 5% intervals over a 30-minute evaluation window.

Decentralized Data Sovereignty

“Decentralized collaboration guarantees data sovereignty. By storing conversations directly in Git refs, technical teams retain permanent ownership of all review history and design decisions.”