Merge pull request #14 from blueflare-energy/docs-style

docs: ASCII typography and style normalization

.github/workflows/ci.yml

@@ -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 quirk — build calls bare python)
+      - name: provision `python` (SDK quirk, the 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