Skip to content

Commit 7a8a976

Browse files
docs: professional-voice sweep across all chapters
Recast ~2700 em dashes to colons, parentheticals, semicolons, and sentence splits across all 57 _docs chapters (bodies, figure captions and alt text, Tools-used callouts, bullet lists, front-matter title/description, status footers). Also cleared confessional (honest/plainly), defensive contrast (genuine/real/on-purpose/for-free), meta-narration (worth naming, rest-of-the- book), generated tells (load-bearing/earns-its-keep), school framing, and filler; trimmed deliberately to at most one reasoned instance per chapter. Applied the repo's lie-rule (keep machine-subject 'lie'/the --lie flag/recorded output; recast work-subject). Kept the Go debugger tool name 'delve'/'dlv'. Front-matter values quoted where a recast introduced a colon. Seven parallel executors, validated centrally. Jekyll build clean (no YAML exceptions).
1 parent 786bf56 commit 7a8a976

57 files changed

Lines changed: 2743 additions & 2743 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎_docs/00-outline.md‎

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,26 +2,26 @@
22
title: "Outline"
33
order: 0
44
part: "Setting Up"
5-
description: "The full arc of this book — fourteen parts, forty-nine chapters, six programs that grow with you, three languages the whole way."
5+
description: "The full arc of this book: fourteen parts, forty-nine chapters, six programs that grow with you, three languages the whole way."
66
---
77

8-
This book teaches Linux systems programming three times at once — in modern
9-
**C++23**, **Go**, and **Rust** — for developers who already program and want to
8+
This book teaches Linux systems programming three times at once, in modern
9+
**C++23**, **Go**, and **Rust**, for developers who already program and want to
1010
understand what their code asks of the kernel. Every hands-on chapter ships a
1111
runnable example implemented idiomatically in all three languages, presented in
1212
switchable code tabs, and every example doubles as a standalone demo.
1313

1414
{% include excalidraw.html
1515
file="00-course-map"
1616
alt="Course map: four journey stages - Foundations, Core systems, Operating context, and Mastery - shown as bands containing the fourteen parts with their chapter ranges, and the six artifacts fwatch, shmkv, chatterd, pmon, bugfarm, and sysagent along the bottom, each with an arrow to the part where it grows."
17-
caption="Figure 0.1 — the course at a glance." %}
17+
caption="Figure 0.1: the course at a glance." %}
1818

1919
Two threads run through the whole book and never stop:
2020

21-
- **Errors, three ways** — how `errno` becomes `std::expected`, a wrapped Go
21+
- **Errors, three ways**: how `errno` becomes `std::expected`, a wrapped Go
2222
`error`, or a Rust `Result`, and what a *policy* for `EINTR`, `EAGAIN`, and
2323
partial failure looks like in each language.
24-
- **The concurrency lens** — which of the three concurrency models each
24+
- **The concurrency lens**: which of the three concurrency models each
2525
chapter's example leans on (`std::jthread` and atomics, goroutines and
2626
channels, ownership and `Send`/`Sync`), and why.
2727

@@ -34,7 +34,7 @@ artifacts that grow chapter by chapter:
3434
|---|---|---|
3535
| `pmon` | a process supervisor: fork/exec, signals, pidfds, privilege dropping, namespaces, pid 1 | 11 → 14, 18 → 19, 32, 34, 41 |
3636
| `fwatch` | a file watcher: polling → inotify/epoll → io_uring → sandboxed with Landlock | 07 → 10, 33, 41 |
37-
| `shmkv` | an mmap-backed key-value store shared across processes — and across languages | 16, 20 |
37+
| `shmkv` | an mmap-backed key-value store shared across processes, and across languages | 16, 20 |
3838
| `chatterd` | a peer-to-peer chat daemon: TCP → epoll at scale → UDP discovery → async → low-latency | 21 → 27, 34, 38, 40, 41 |
3939
| `sysagent` | a metrics agent reading /proc, /sys, and cgroups, exporting OpenTelemetry | 36 → 38, 41 |
4040
| `bugfarm` | a corpus of seeded bugs for learning gdb, valgrind, sanitizers, and eBPF tools | 28 → 31 |
@@ -54,25 +54,25 @@ artifacts that grow chapter by chapter:
5454
| **Debugging** | gdb and remote debugging, valgrind vs sanitizers vs miri, eBPF observation tools, per-language toolbelts | 28–31 |
5555
| **Containers and Virtualization** | namespaces and cgroups, seccomp and Landlock, our programs in containers, KVM and the isolation spectrum | 32–35 |
5656
| **Observability** | /proc and /sys by hand, the USE method, OpenTelemetry into Grafana/Loki/Tempo/Mimir | 36–38 |
57-
| **Performance and Low Latency** | benchmarking without self-deception, pinned-core fast paths, the capstone fleet | 39–41 |
57+
| **Performance and Low Latency** | benchmarking without self-deception, pinned-core fast paths, the final project fleet | 39–41 |
5858
| **Deep Dives** | embedding Lua, Rust macros for systems code, the Go runtime | 42–44 |
5959
| **Appendices: Tooling** | Cockpit, SystemTap, and PCP; the C++, Go, and Rust toolboxes | 45–48 |
6060
| **Compendium: C++ Concurrency** | concurrency vs parallelism, pthreads, std threading, Boost.Thread, C++20 coroutines, Boost.Fiber, Boost.Asio, and a measured comparison of all six | 49–56 |
6161

6262
## Where things run
6363

6464
Examples run **locally** on your Fedora 44 machine unless they need root, kernel
65-
observation, or a second host — those run in the disposable KVM lab
65+
observation, or a second host; those run in the disposable KVM lab
6666
(`systems-target`, and `systems-peer` for two-host networking) that Chapter 2
6767
provisions. Observability chapters use a local Podman LGTM stack (Grafana,
6868
Loki, Tempo, Mimir) plus Performance Co-Pilot from its container image. Nothing
6969
experimental ever runs un-snapshotted on your workstation.
7070

71-
> **Note** — every example section carries a verification status. A demo is
71+
> **Note**: every example section carries a verification status. A demo is
7272
> marked *verified* only when it has produced its claimed observable effect on
73-
> the stated environment — never merely because it compiled. That claim is
73+
> the stated environment, never merely because it compiled. That claim is
7474
> enforced by machinery, not habit: the runner, `scripts/test-all-examples.py`,
7575
> builds each example in all three languages and then executes the example's own
7676
> Lua `verify.lua` harness, which must observe the behavior to report a PASS. If
7777
> the VM lab or the LGTM stack an example depends on is down, the runner reports
78-
> a SKIP — never a false PASS.
78+
> a SKIP, never a false PASS.

0 commit comments

Comments
 (0)