Skip to content

docs: add a Why Not std::execution design page - #456

Open
mvandeberg wants to merge 1 commit into
cppalliance:developfrom
mvandeberg:pr/403-why-not-std-execution
Open

mvandeberg wants to merge 1 commit into
cppalliance:developfrom
mvandeberg:pr/403-why-not-std-execution

Conversation

@mvandeberg

Copy link
Copy Markdown
Contributor

Give the std::execution comparison its own page beside the Asio, Cobalt and TooManyCooks comparisons. The page contrasts the two models' context direction, frame-allocation timing, scheduling primitives and stop-token handling, lists what Capy gives up, and links both sender bridges and the BOOST1001 comparison paper.

The context-direction and frame-allocation-timing argument was repeated in the Executor, Run API and Why Not Asio pages. Each now keeps its topic-specific point and links to the new page. The sender bridge example and the ContextAwaitable tutorial link to it as well. Why Not Asio also now describes std::execution and P3552 task as in the C++26 working draft, and no longer claims the frame allocator can't be a parameter.

Closes #403

Give the std::execution comparison its own page beside the Asio,
Cobalt and TooManyCooks comparisons. The page contrasts the two
models' context direction, frame-allocation timing, scheduling
primitives and stop-token handling, lists what Capy gives up, and
links both sender bridges and the BOOST1001 comparison paper.

The context-direction and frame-allocation-timing argument was
repeated in the Executor, Run API and Why Not Asio pages. Each now
keeps its topic-specific point and links to the new page. The sender
bridge example and the ContextAwaitable tutorial link to it as well.
Why Not Asio also now describes std::execution and P3552 task as in
the C++26 working draft, and no longer claims the frame allocator
can't be a parameter.

Closes cppalliance#403
@cppalliance-bot

Copy link
Copy Markdown

An automated preview of the documentation is available at https://456.capy.prtest3.cppalliance.org/index.html

If more commits are pushed to the pull request, the docs will rebuild at the same URL.

2026-10-17 15:49:12 UTC

@cppalliance-bot

Copy link
Copy Markdown

GCOVR code coverage report https://456.capy.prtest3.cppalliance.org/gcovr/index.html
LCOV code coverage report https://456.capy.prtest3.cppalliance.org/genhtml/index.html
Coverage Diff Report https://456.capy.prtest3.cppalliance.org/diff-report/index.html

Build time: 2026-10-17 16:02:15 UTC

@codecov

codecov Bot commented Oct 17, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.43%. Comparing base (ef63862) to head (8e8c1ef).

Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff            @@
##           develop     #456   +/-   ##
========================================
  Coverage    98.43%   98.43%           
========================================
  Files          137      137           
  Lines         7297     7297           
========================================
  Hits          7183     7183           
  Misses         114      114           
Flag Coverage Δ
linux 98.40% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.


Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update ef63862...8e8c1ef. Read the comment docs.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Backlog

Development

Successfully merging this pull request may close these issues.

docs: make "Why not std::execution" a peer design page and link the comparison paper

2 participants