Skip to content

docs: reorganize guide and benchmark documentation - #125

Open
LimiNode wants to merge 6 commits into
docs/api-documentation-hardeningfrom
docs/information-architecture
Open

docs: reorganize guide and benchmark documentation#125
LimiNode wants to merge 6 commits into
docs/api-documentation-hardeningfrom
docs/information-architecture

Conversation

@LimiNode

@LimiNode LimiNode commented Sep 7, 2026

Copy link
Copy Markdown
Owner

Summary\n- split the concise Doxygen landing page from the detailed API reference\n- add dedicated quick-start, backend matrix, and benchmark guides\n- centralize benchmark methodology and add publication smoke/link checks\n\n## Validation\n- Doxygen 1.12.0 generation succeeds without warnings\n- generated page/link smoke checks pass locally\n\nThis PR is intentionally stacked on the documentation hardening changes in #124.

@LimiNode
LimiNode force-pushed the docs/information-architecture branch 2 times, most recently from 71e8c88 to eff727c Compare September 7, 2026 13:24
Split the Doxygen landing page from the detailed API reference and add focused quick-start, backend, and benchmark guides. Extend publication checks to cover the new pages and validate generated local links.
@LimiNode
LimiNode force-pushed the docs/information-architecture branch from eff727c to 0698221 Compare September 7, 2026 13:25
Document shared OTLP dependencies and asynchronous payload delivery, centralize backend and benchmark references, and add a complete installation guide. Validate documentation on pull requests with dynamic version checks.
Update queue configuration examples to use the stable logit::QueuePolicy name introduced by the API cleanup.
Make logit.hpp the supported application entry point and document that log_macros.hpp is aggregate-owned without a standalone inclusion guarantee. Keep standalone contracts explicit for public type headers.
Describe the distinct MPSC DropOldest semantics and represent LogRecord::format as a format field in both README variants.
Use the supported umbrella entry point in Prometheus examples and avoid implying standalone contracts for aggregate-owned headers or public aliases.
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.

1 participant