Skip to content

docs(unified): add comprehensive Unified API interface guide#689

Merged
kcenon merged 2 commits into
mainfrom
docs/issue-685-document-unified-api-interfaces
Feb 9, 2026
Merged

docs(unified): add comprehensive Unified API interface guide#689
kcenon merged 2 commits into
mainfrom
docs/issue-685-document-unified-api-interfaces

Conversation

@kcenon

@kcenon kcenon commented Feb 9, 2026

Copy link
Copy Markdown
Owner

Closes #685

Summary

  • Add docs/UNIFIED_API_GUIDE.md documenting the Unified API interface layer
  • Document all 3 core interfaces: i_transport (base), i_connection (lifecycle), i_listener (server-side)
  • Document all 4 foundation types: endpoint_info, connection_callbacks, listener_callbacks, connection_options
  • Include interface hierarchy diagram and connection state machine with state transition table
  • Provide protocol support matrix (TCP, UDP, WebSocket, QUIC, HTTP, TLS)
  • Add 8 protocol-agnostic code examples (send function, connection handler, echo server, broadcast server, etc.)
  • Include custom protocol extension guide with implementation contracts

Test Plan

  • Verify all code examples reference correct types and method signatures from headers
  • Review API reference tables against actual struct/interface declarations
  • Confirm documentation links and cross-references are correct

Verification Results

Test Item Status Details
Code examples vs headers PASS All examples verified (includes, namespaces, signatures, designated initializers)
API reference tables PASS All methods, fields, types, defaults, noexcept qualifiers match
Documentation links PASS 8 internal anchors, 4 header paths, all class names correct

One MEDIUM issue found and fixed in second commit: missing endpoint_info C-string constructor overloads.

Document all 3 unified interfaces (i_transport, i_connection, i_listener)
and foundation types (endpoint_info, connection_callbacks, listener_callbacks,
connection_options). Includes interface hierarchy, connection state machine,
protocol support matrix, protocol-agnostic code examples, and guide for
extending with custom protocol implementations.

Closes #685
Add documentation for the const char* constructor overloads of
endpoint_info that were present in the header but missing from
the guide.
@github-actions

github-actions Bot commented Feb 9, 2026

Copy link
Copy Markdown
Contributor

Performance Comparison

Base Branch Results

No base results

PR Branch Results

No PR results

1 similar comment
@github-actions

github-actions Bot commented Feb 9, 2026

Copy link
Copy Markdown
Contributor

Performance Comparison

Base Branch Results

No base results

PR Branch Results

No PR results

@kcenon kcenon merged commit 572c732 into main Feb 9, 2026
41 checks passed
@kcenon kcenon deleted the docs/issue-685-document-unified-api-interfaces branch February 9, 2026 06:02
kcenon added a commit that referenced this pull request Apr 13, 2026
* docs(unified): add comprehensive Unified API interface guide

Document all 3 unified interfaces (i_transport, i_connection, i_listener)
and foundation types (endpoint_info, connection_callbacks, listener_callbacks,
connection_options). Includes interface hierarchy, connection state machine,
protocol support matrix, protocol-agnostic code examples, and guide for
extending with custom protocol implementations.

Closes #685

* docs(unified): add missing endpoint_info C-string constructor overloads

Add documentation for the const char* constructor overloads of
endpoint_info that were present in the header but missing from
the guide.
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.

[Task] docs: Document Unified API interfaces (i_connection, i_listener, i_transport)

1 participant