Skip to content

Conversation

@randlee
Copy link
Owner

@randlee randlee commented Jan 19, 2026

Summary

This PR adds comprehensive documentation for the new impact classification (v0.7.0) and whitespace handling (v0.8.0) features completed over the weekend.

Documentation Added

New Documentation Files

  • docs/impact-classification.md (~3,450 words)

    • Four impact levels (Breaking Public API, Breaking Internal API, Non-Breaking, Formatting Only)
    • Classification algorithm and visibility tracking
    • CLI options (--impact-level, --include-non-impactful, --include-formatting)
    • Caveat warning system with mitigation strategies
    • JSON Schema v2 complete reference
    • 5 real-world use cases and detailed examples
  • docs/whitespace-handling.md (~2,670 words)

    • Four whitespace modes (Exact, IgnoreLeadingTrailing, IgnoreAll, LanguageAware)
    • Five whitespace issue types with automatic detection
    • Language classification (11 whitespace-significant, 14 insignificant languages)
    • Mode selection guide and best practices
    • Output format examples across JSON, HTML, Terminal, Plain Text
  • docs/screenshot-requirements.md (10KB)

    • Specifications for HTML and JSON screenshots
    • Three capture methods (manual, Playwright, DevTools)
    • Quality checklists and requirements

Updated Documentation

  • README.md

    • Added "Why Roslyn over tree-sitter?" section
    • Reorganized features to highlight v0.7.0 and v0.8.0 prominently
    • Added screenshot section with links to samples
    • Documented new CLI options
    • Updated JSON example to show schema v2
    • Added Synaptic Canvas integration section
    • Reorganized documentation links by category
  • docs/output-formats.md (~1,150 words added)

    • Split JSON schema documentation into v1 (legacy) and v2 (current)
    • Added "New Features in v0.7.0 and v0.8.0" section
    • Documented impact classification across all formats
    • Documented whitespace warnings across all formats
    • Added 6 new jq examples for schema v2

Sample Files

  • samples/impact-demo/

    • old.cs and new.cs (realistic PaymentService example)
    • output.json, output.html, output-filtered.json
    • Demonstrates all four impact levels
  • samples/README.md

    • Guide to all sample files
    • Explanation of impact levels
    • Regeneration instructions
  • Updated existing samples

    • Regenerated samples/output-example.* with v0.8.0
    • Now include impact classification and v2 schema

Screenshot Infrastructure

  • docs/images/ directory created
    • README.md with quick start guide
    • html-output-screenshot.png.TODO with detailed capture instructions
    • json-impact-breakdown.png.TODO with detailed capture instructions

Key Features Documented

Impact Classification (v0.7.0)

  • Automatic categorization of changes by consumer impact
  • Visibility tracking (Public, Internal, Private, Protected, Local)
  • Caveat warnings for edge cases
  • Smart filtering defaults (JSON shows breaking, HTML shows all)
  • JSON Schema v2 with impactBreakdown statistics

Whitespace Handling (v0.8.0)

  • Language-aware whitespace detection
  • Four configurable modes for different use cases
  • Automatic issue detection (indentation, mixed tabs/spaces, trailing whitespace, line endings)
  • Integration with output formats for warnings

Impact

  • Provides developers with complete understanding of new features
  • Includes practical examples and use cases
  • Cross-references documentation for easy navigation
  • Maintains concise README with links to detailed guides
  • Ready for publication and user onboarding

Testing

  • All samples regenerated with v0.8.0
  • Documentation verified against actual implementation
  • Links tested between documents

🤖 Generated with Claude Code

Added detailed documentation for the new impact classification (v0.7.0)
and whitespace handling (v0.8.0) features:

- Created docs/impact-classification.md (~3,450 words)
  - Four impact levels with detailed examples
  - Classification algorithm and decision matrix
  - CLI options and smart defaults
  - Caveat warning system
  - JSON Schema v2 documentation
  - Real-world use cases and examples

- Created docs/whitespace-handling.md (~2,670 words)
  - Four whitespace modes with detailed behavior
  - Five whitespace issue types with detection
  - Language classification (11 significant, 14 insignificant)
  - Mode selection guide and best practices
  - Output format coverage for all modes

- Updated docs/output-formats.md (~1,150 words added)
  - Split JSON schema into v1 (legacy) and v2 (current)
  - Added impact classification across all formats
  - Added whitespace warnings documentation
  - New jq examples for v2 schema

- Updated README.md with concise overview
  - Added "Why Roslyn over tree-sitter?" section
  - Highlighted v0.7.0 and v0.8.0 features prominently
  - Added screenshot placeholders with links to samples
  - Documented new CLI options (--impact-level, --whitespace-mode)
  - Updated JSON example to show schema v2
  - Added Synaptic Canvas integration section
  - Reorganized documentation links by category

- Created samples/impact-demo/ with realistic examples
  - old.cs and new.cs demonstrating all impact levels
  - Generated output.json, output.html, output-filtered.json
  - samples/README.md with regeneration instructions

- Created screenshot infrastructure
  - docs/screenshot-requirements.md with specifications
  - docs/images/ directory with README
  - Placeholder .TODO files with detailed capture instructions

- Regenerated existing samples with v0.8.0
  - Updated output-example.json and output-example.html
  - Now include impact classification and v2 schema

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@randlee randlee merged commit d5d15ee into main Jan 19, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants