Repository navigation
Commit 428abc1
Docs: the AsyncReads() how-to, with the measured reasons and four figures (#166)
* Docs: the AsyncReads() how-to (why it exists, what it does, when to use it, with the measured costs)
A new guide page, "Row reads: sync by default, AsyncReads() to opt in":
the default stated plainly, where a thread waits (figure), the measured
reasons for the sync default (CPU, memory, wall time on a real link),
and a dedicated AsyncReads() section: what it does, when to use it, what
it costs, the busy-pool hazard and the large-value warning for Map(Func).
Every number is labeled with its run and "one run"; the thread-pool
benefit, the busy pool on a real link and Map(Func) on a 100 MB value are
marked UNMEASURED.
Four SVGs (light and dark), a compiled side-by-side sample
(AsyncReads.cs) with new sample checks, one sentence and link in the
mapping article, and one line in the table of contents. Docs only: no
Source, Tests or PublicAPI change.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
* Docs: the AsyncReads() figures draw their own background card and scroll sideways on a phone
Each of the four SVGs now paints a solid background card (the same
--bg/--frame variables as the performance charts), so it stays readable
when the site theme and the OS color scheme differ. Data bars are solid
fills in the family colors with rounded ends and no outline. In the
article each figure sits in an overflow-x container with a 600 px
minimum width, so text never drops below 13 px at phone width. Docs
only.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
* Docs: the AsyncReads() page writes microseconds as µs
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>1 parent 9fe6d2e commit 428abc1
9 files changed
Lines changed: 701 additions & 0 deletions
File tree
- docsite
- articles
- images
- samples
Large diffs are not rendered by default.
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
267 | 267 | | |
268 | 268 | | |
269 | 269 | | |
| 270 | + | |
| 271 | + | |
270 | 272 | | |
271 | 273 | | |
272 | 274 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
3 | 3 | | |
4 | 4 | | |
5 | 5 | | |
| 6 | + | |
6 | 7 | | |
7 | 8 | | |
8 | 9 | | |
| |||
0 commit comments