Skip to content

docs(proxy): document proxy layer (proxy_connector, proxy_config)#357

Merged
kcenon merged 1 commit into
mainfrom
docs/issue-353-document-proxy-layer
Feb 8, 2026
Merged

docs(proxy): document proxy layer (proxy_connector, proxy_config)#357
kcenon merged 1 commit into
mainfrom
docs/issue-353-document-proxy-layer

Conversation

@kcenon

@kcenon kcenon commented Feb 8, 2026

Copy link
Copy Markdown
Owner

Closes #353

Summary

  • Add comprehensive proxy layer documentation at docs/guides/PROXY_LAYER.md covering architecture, configuration, API reference, usage examples, backend integration, and performance considerations
  • Update docs/API_REFERENCE.md with proxy mode API section (proxy_connection_config, proxy_connector, database_manager proxy API)
  • Update docs/ARCHITECTURE.md with proxy layer in architecture diagram and backend implementations list

Changes

New Files

  • docs/guides/PROXY_LAYER.md — Full proxy layer documentation with:
    • Architecture overview (purpose, connector hierarchy, direct vs proxy comparison)
    • Configuration reference (all proxy_connection_config parameters documented)
    • API reference (proxy_connector class, proxy_state enum, connection lifecycle)
    • 4 usage examples (basic setup, TLS, mTLS, fallback strategy)
    • Backend integration details and limitations
    • Performance considerations
    • Current status and roadmap

Modified Files

  • docs/API_REFERENCE.md — Added Proxy Mode section with config/connector/manager API
  • docs/ARCHITECTURE.md — Updated architecture diagram to show direct/proxy split, added proxy_connector to backend list, documented connection modes

Test Plan

  • Build succeeds (cmake --build passes, 92% tests pass — 19 failures are pre-existing integration tests unrelated to docs)
  • Documentation renders correctly on GitHub (all Markdown syntax verified: 12 tables, 20+ code blocks, 30+ headings)
  • Links between documents resolve correctly (6/6 cross-document links verified)
  • Code examples are consistent with source API (all method signatures, types, defaults, enums, include paths, namespaces verified against source headers)

Document the database proxy layer including architecture overview,
proxy_config.h parameters, proxy_connector.h API reference, usage
examples with TLS/mTLS, backend integration details, and performance
considerations. Update API_REFERENCE.md and ARCHITECTURE.md to
include proxy layer references.
@kcenon kcenon merged commit 16dda63 into main Feb 8, 2026
23 checks passed
@kcenon kcenon deleted the docs/issue-353-document-proxy-layer branch February 8, 2026 14:42
kcenon added a commit that referenced this pull request Apr 13, 2026
Document the database proxy layer including architecture overview,
proxy_config.h parameters, proxy_connector.h API reference, usage
examples with TLS/mTLS, backend integration details, and performance
considerations. Update API_REFERENCE.md and ARCHITECTURE.md to
include proxy layer references.
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 proxy layer (proxy_connector, proxy_config)

1 participant