Skip to content

docs: enhance examples with Doxygen tags and create Getting Started guide#655

Merged
kcenon merged 3 commits into
mainfrom
docs/issue-653-enhance-examples-getting-started
Apr 5, 2026
Merged

docs: enhance examples with Doxygen tags and create Getting Started guide#655
kcenon merged 3 commits into
mainfrom
docs/issue-653-enhance-examples-getting-started

Conversation

@kcenon

@kcenon kcenon commented Apr 5, 2026

Copy link
Copy Markdown
Owner

Summary

  • Add @example Doxygen tags to existing code samples for improved documentation indexing
  • Create comprehensive Getting Started guide covering prerequisites, installation, first thread pool, job submission, priority queues, DAG scheduling, work stealing, and metrics
  • Create API Quick Reference cheat sheet covering thread pool creation, job submission/cancellation, priority queues, DAG scheduling, autoscaler config, and metrics

Test plan

  • Verify Doxygen builds without warnings
  • Review Getting Started guide for accuracy
  • Confirm API Quick Reference covers all major APIs

Closes #653

kcenon added 3 commits April 5, 2026 12:33
Add @file, @example, @brief, and @see tags to all 19 example .cpp
files. Files that already had partial Doxygen blocks (config_example,
crash_protection, integration_example, queue_capabilities_sample,
queue_factory_sample, multi_process_monitoring_integration) are
updated with consistent formatting and the missing @example/@see tags.
@github-actions

github-actions Bot commented Apr 5, 2026

Copy link
Copy Markdown
Contributor

📊 Performance Benchmark Results

Performance Benchmark Report

No benchmark data available.

ℹ️ No baseline reference available

This is the first benchmark run or baseline file is missing.

@kcenon kcenon merged commit 9794102 into main Apr 5, 2026
34 of 35 checks passed
@kcenon kcenon deleted the docs/issue-653-enhance-examples-getting-started branch April 5, 2026 05:07
kcenon added a commit that referenced this pull request Apr 13, 2026
…uide (#655)

* docs: add Doxygen example tags to existing examples

Add @file, @example, @brief, and @see tags to all 19 example .cpp
files. Files that already had partial Doxygen blocks (config_example,
crash_protection, integration_example, queue_capabilities_sample,
queue_factory_sample, multi_process_monitoring_integration) are
updated with consistent formatting and the missing @example/@see tags.

* docs: create Getting Started guide

* docs: create API Quick Reference cheat sheet
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.

docs: Enhance examples with categories and create Getting Started guide

1 participant