Closes #430

Summary

Added comprehensive writer framework documentation (docs/WRITER_GUIDE.md) covering:

• Architecture: Decorator pattern explanation, inheritance chain (base_writer → decorator_writer_base), and stack visualization diagrams
• Writer Catalog: Complete documentation of all 18 writer types
  • 5 Base Writers: console, file, rotating_file, network, otlp
  • 13 Decorator Writers: async, batch, buffered, filtered, formatted, thread_safe, encrypted, critical, composite, queued_writer_base, legacy_writer_adapter
• Composition Patterns: 6 patterns from simple console to high-throughput production stacks
• Recommended Stacks: 25+ configurations for:
  • Development (console, async console, formatted console)
  • Production file logging (simple, rotating, high-throughput, JSON)
  • Compliance & security (encrypted, audit trail, tamper-evident)
  • Distributed systems (remote logging, OTLP export, multi-destination)
  • Resource-constrained (minimal memory, low CPU, embedded)
• Code Examples: 5 real-world examples with complete stack configurations
• Performance Impact: Detailed analysis of throughput (up to 4.34M msg/sec), latency (down to 148ns), and memory usage per decorator

Documentation Content

• Decorator Pattern: Visual diagrams showing inheritance chain and stack composition
• Each Writer Documented: Constructor signatures, features, use cases, performance impact
• Stack Visualizations: Call flow diagrams for complex compositions (6-layer stacks)
• Performance Tables: Throughput comparison (500K → 4.34M msg/sec), latency per decorator (5ns → 300ns), memory usage
• Best Practices: 8 guidelines (filter early, use async for I/O, batch+buffer for throughput, etc.)

Highlights

Performance achievements documented:

• 4.34M msg/sec throughput (high-throughput stack)
• 148ns latency (async writer enqueue time)
• 860% improvement over baseline (async optimization)

Writer stacks for common scenarios:

• Development: console or async → console
• Production: rotating_file → buffered → batch → async → formatted → filtered
• Compliance: file → encrypted → critical → formatted → filtered
• Distributed: network → async → batch → formatted → filtered

Test Plan

• All 18 writers cataloged with descriptions
• Base vs decorator distinction clear
• 6 composition patterns documented with visualizations
• 25+ recommended stacks for various use cases
• 5 code examples with complete configurations
• Performance impact per decorator documented (throughput, latency, memory)
• Stack visualization diagrams included
• Document reviewed for technical accuracy
• API signatures verified against header files