Skip to content

Good first issue: add README diagram alt-text and ASCII-only lifecycle explanation #12

Description

@safal207

Goal

Improve accessibility and readability of the CaPU lifecycle by adding a simple ASCII-only explanation near the existing diagram material.

Context

CaPU has a central lifecycle:

Gate -> Incubate -> Commit -> Execute

New readers should be able to understand this even if Mermaid diagrams do not render.

Suggested change

Add a concise ASCII explanation to the README or a small docs page, then link it from the README if needed.

Acceptance criteria

  • Explain the lifecycle in 5-10 lines.
  • Include the key invariant: no execute before commit.
  • Mention reject/hold paths.
  • Keep it readable in plain text.
  • Do not modify runtime code.

Contributor level

Beginner / docs-only.

Why this helps community

This is a small first PR that improves the project for screen readers, terminals, plain Markdown viewers, and first-time contributors.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions