docs: ASCII typography and style normalization across all repo text

Replace every em dash with real punctuation (rewrites, not hyphen swaps)
in docs, code comments, scripts, configs, and the port records; convert
en dashes, curly quotes, ellipsis glyphs, arrows, and section signs to
ASCII; drop machine-writing tell phrases from living docs. ADR titles
now use a colon. The M2 bring-up DTS model string carried an em dash
into the patch series and its record echoes; fixed at both, and the full
series re-verified to apply cleanly onto pristine 6.18.46. One comment
in freshness.h deliberately names the em dash glyph the UI renders as
the unknown mark; that is data, kept as prose naming it.

Verified: cargo tests (sim, config-lint, rs485-bridge), shellcheck,
both driver MC/DC harnesses, patches-apply.
This commit is contained in:
BFE Engineering
2026-08-31 12:31:27 -06:00
parent 80d9a9539b
commit 42fb386f60
111 changed files with 1261 additions and 1261 deletions
+7 -7
View File
@@ -2,7 +2,7 @@
#
# Policy (mirrors flare-edge): only GitHub-owned actions get the repo token; the one
# third-party helper (taiki-e/install-action) is pinned and never handed a token.
# Every job runs on GitHub-hosted runners no self-hosted runner may be reachable
# Every job runs on GitHub-hosted runners: no self-hosted runner may be reachable
# from this repo's workflows (ADR-0007: public-repo fork PRs would otherwise be
# able to run code on private infrastructure). kernel-build is dispatch-only.
name: ci
@@ -146,7 +146,7 @@ jobs:
# Automatic artifact GC (mirrors flare-edge). An exceeded account-wide Actions
# storage quota blocks ALL new runs (startup_failure), not just uploads, so
# before a new kernel artifact is uploaded, drop older kernel-rv1106 artifacts
# beyond the newest few storage stays bounded across dispatches. gh + the
# beyond the newest few: storage stays bounded across dispatches. gh + the
# built-in token (no third-party action); needs actions:write to delete.
# Best-effort: it never fails the run, so it can't block the build that needs it.
prune-artifacts:
@@ -177,8 +177,8 @@ jobs:
kernel-build:
# Full hermetic build on a GitHub-hosted runner (ADR-0007; supersedes the
# self-hosted half of ADR-0004 a self-hosted runner must never be reachable
# from a public repo's workflows). Manual-dispatch by design a full kernel
# self-hosted half of ADR-0004: a self-hosted runner must never be reachable
# from a public repo's workflows). Manual-dispatch by design: a full kernel
# build is heavy; trigger via `gh workflow run ci.yml` / the Actions UI.
if: github.event_name == 'workflow_dispatch'
needs: [prune-artifacts]
@@ -191,7 +191,7 @@ jobs:
sudo apt-get update -qq
sudo apt-get install -y -qq gcc-arm-linux-gnueabihf qemu-system-arm \
cpio bc bison flex libssl-dev ccache
- name: provision `python` (SDK quirkbuild calls bare python)
- name: provision `python` (SDK quirk: build calls bare python)
run: |
mkdir -p "$RUNNER_TEMP/bin"
ln -sf "$(command -v python3)" "$RUNNER_TEMP/bin/python"
@@ -225,7 +225,7 @@ jobs:
# (zImage alone emits no Module.symvers); only these dirs' .ko files
# are collected/uploaded.
WARDEN_MODULES_COLLECT: drivers/net/wireless/aic8800
# KERNEL_TARBALL is exported from the SHELL so $HOME expands — a literal
# KERNEL_TARBALL is exported from the SHELL so $HOME expands. A literal
# `~` in a YAML env: value is never tilde-expanded and broke every
# dispatch until caught in review.
run: |
@@ -242,7 +242,7 @@ jobs:
"$RUNNER_TEMP/kbuild-out/linux-6.18.46/arch/arm/boot/zImage"
# Best-effort: the build IS the gate. Uploading the zImage/dtb to GitHub
# artifact storage can fail on an account-wide storage-quota hit (recalculated
# every 6-12h) that has nothing to do with this build — don't red-X a good
# every 6-12h) that has nothing to do with this build. Don't red-X a good
# kernel build over it.
- uses: actions/upload-artifact@v4
continue-on-error: true