Skip to content

CLAUDE.md

Latest commit

 

History

History
62 lines (43 loc) · 2.21 KB

CLAUDE.md

File metadata and controls

62 lines (43 loc) · 2.21 KB

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository Overview

This is an IETF Internet-Draft repository for Media over QUIC (MOQ) protocol specifications authored by Luke Curley. It contains three draft documents:

  • draft-lcurley-moq-lite.md: A simplified MOQ transport protocol for real-time conferencing
  • draft-lcurley-moq-hang.md: Specification for handling connection hangs in MOQ
  • draft-lcurley-moq-use-cases.md: MOQ protocol use cases documentation

Build Commands

# Build all drafts (generates HTML and text versions)
make

# Clean build artifacts
make clean

# Update GitHub Pages (typically done via CI)
make gh-pages

Development Workflow

  1. Prerequisites: The build system requires i-d-template tools. See setup instructions.

  2. Building drafts: Running make will:

    • Initialize the i-d-template submodule if needed
    • Convert Markdown drafts to RFC XML format
    • Generate HTML and text versions
    • Output files: draft-*.html and draft-*.txt

  3. Git workflow:

    • Main branch: main
    • Pull requests automatically trigger CI builds
    • GitHub Pages updates on push to main
    • Draft versions are released to the IETF datatracker by pushing a tag: draft-lcurley-<name>-XX (e.g. draft-lcurley-moq-lite-04)

Architecture

This is a standards documentation project, not a software implementation. Key components:

  • Draft documents: Root-level draft-*.md files in kramdown-rfc format
  • Build system: Uses i-d-template via git submodule in lib/
  • CI/CD: GitHub Actions workflows handle building and publishing
  • Output: Published to GitHub Pages at https://kixelated.github.io/moq-drafts/

Working Group Context

  • Part of IETF Media Over QUIC (MOQ) Working Group
  • Discussion: moq@ietf.org mailing list
  • Related to main MoqTransport specification (moq-lite is a simplified alternative)

Important Notes

  • Follow IETF contribution guidelines (BCP 78/79)
  • Draft format uses kramdown-rfc with YAML frontmatter
  • References are managed via bibxml includes
  • Do not edit generated files (*.html, *.txt)