Replace box-drawing characters with plain ASCII in all docs

taylorarndt · taylorarndt · commit 600d996f235e · 2026-03-07T14:37:52.000-06:00
diff --git a/docs/02-navigating-repositories.md b/docs/02-navigating-repositories.md
@@ -30,25 +30,25 @@ Use this sequence before moving to graded chapters:
 When you navigate to a GitHub repository (e.g., `https://github.com/owner/repo-name`), you land on the **repository home page** (also called the Code tab). This page has several distinct regions:
 
 ```text
-┌────────────────────────────────────────────────────┐
-│  Navigation bar (GitHub global nav)                │
-│  avatar menu | Notifications | search               │
-├────────────────────────────────────────────────────┤
-│  Repository header                                  │
-│  owner / repo-name  (h1)                            │
-│  [Star] [Watch] [Fork] buttons                      │
-├────────────────────────────────────────────────────┤
-│  Repository navigation tabs (landmark)              │
-│  < Code > Issues  Pull requests  Actions  etc.      │
-├─────────────────────────────┬──────────────────────┤
-│  File tree / code panel     │  Sidebar              │
-│  Branch selector            │  About section        │
-│  Files table (t:table)      │  Topics               │
-│  Last commit message         │  Releases             │
-├─────────────────────────────┴──────────────────────┤
-│  README.md (rendered)                               │
-│  (a separate landmark region)                       │
-└────────────────────────────────────────────────────┘
++----------------------------------------------------+
+|  Navigation bar (GitHub global nav)                |
+|  avatar menu | Notifications | search               |
++----------------------------------------------------+
+|  Repository header                                  |
+|  owner / repo-name  (h1)                            |
+|  [Star] [Watch] [Fork] buttons                      |
++----------------------------------------------------+
+|  Repository navigation tabs (landmark)              |
+|  < Code > Issues  Pull requests  Actions  etc.      |
++-----------------------------+----------------------+
+|  File tree / code panel     |  Sidebar              |
+|  Branch selector            |  About section        |
+|  Files table (t:table)      |  Topics               |
+|  Last commit message         |  Releases             |
++-----------------------------+----------------------+
+|  README.md (rendered)                               |
+|  (a separate landmark region)                       |
++----------------------------------------------------+
 ```
 
 
diff --git a/docs/03-the-learning-room.md b/docs/03-the-learning-room.md
@@ -25,12 +25,12 @@ Before starting Chapter 4 challenges, students should be able to:
 
 ```text
 learning-room (SHARED)
-├── main branch (protected)
-├── Student A's PR #12 (open, assigned to Student B for review)
-├── Student B's PR #13 (open, assigned to Student C for review)
-├── Student C's PR #14 (open, assigned to Student A for review)
-├── Student A's PR #11 (merged, closed)
-└── [More PRs as students contribute]
++-- main branch (protected)
++-- Student A's PR #12 (open, assigned to Student B for review)
++-- Student B's PR #13 (open, assigned to Student C for review)
++-- Student C's PR #14 (open, assigned to Student A for review)
++-- Student A's PR #11 (merged, closed)
++-- [More PRs as students contribute]
 ```
 
 ### Why one shared repo?
@@ -87,28 +87,28 @@ Next step unlocked             Ready to merge
 
 ```text
 learning-room/
-├── README.md                           ← Getting started guide
-├── AUTOMATION.md                       ← How the bot works
-├── .github/
-│   ├── workflows/                      ← 3 automation workflows
-│   │   ├── learning-room-pr-bot.yml            (PR validation)
-│   │   ├── skills-progression.yml              (progress tracking)
-│   │   └── student-grouping.yml                (peer pairing)
-│   ├── scripts/
-│   │   └── validate-pr.js                      (validation logic)
-│   ├── data/
-│   │   ├── student-roster.json                 (your cohort info)
-│   │   └── challenge-progression.json          (levels, badges)
-│   └── docs/
-│       ├── LEARNING_PATHS.md                   (skill progression guide)
-│       └── IMPLEMENTATION_GUIDE.md             (facilitator setup)
-├── docs/
-│   ├── CHALLENGES.md                   ← 12 challenges (Beginner → Expert)
-│   ├── GROUP_CHALLENGES.md             ← 7 collaborative exercises
-│   ├── welcome.md                      ← Has [TODO] to complete
-│   ├── keyboard-shortcuts.md           ← Has intentional errors
-│   └── setup-guide.md                  ← Has broken links
-└── [other files for practice]
++-- README.md                           ← Getting started guide
++-- AUTOMATION.md                       ← How the bot works
++-- .github/
+|   +-- workflows/                      ← 3 automation workflows
+|   |   +-- learning-room-pr-bot.yml            (PR validation)
+|   |   +-- skills-progression.yml              (progress tracking)
+|   |   +-- student-grouping.yml                (peer pairing)
+|   +-- scripts/
+|   |   +-- validate-pr.js                      (validation logic)
+|   +-- data/
+|   |   +-- student-roster.json                 (your cohort info)
+|   |   +-- challenge-progression.json          (levels, badges)
+|   +-- docs/
+|       +-- LEARNING_PATHS.md                   (skill progression guide)
+|       +-- IMPLEMENTATION_GUIDE.md             (facilitator setup)
++-- docs/
+|   +-- CHALLENGES.md                   ← 12 challenges (Beginner → Expert)
+|   +-- GROUP_CHALLENGES.md             ← 7 collaborative exercises
+|   +-- welcome.md                      ← Has [TODO] to complete
+|   +-- keyboard-shortcuts.md           ← Has intentional errors
+|   +-- setup-guide.md                  ← Has broken links
++-- [other files for practice]
 ```
 
 
diff --git a/docs/04-working-with-issues.md b/docs/04-working-with-issues.md
@@ -313,15 +313,15 @@ When you open an issue, the page structure is:
 [Issue title - h1]
 [Open/Closed status badge]
 [Author, timestamp, comment count]
-─────────────────────────────────
+---------------------------------
 [Issue description - Main content]   ← the original post
 [Labels, Assignees sidebar - h3s]
-─────────────────────────────────
+---------------------------------
 [Activity / Timeline]                ← comments and events
   [First comment - h3]
   [Second comment - h3]
   ...
-─────────────────────────────────
+---------------------------------
 [Add a comment - landmark]
 [Comment text area]
 [Close issue / Submit button]
diff --git a/docs/05-working-with-pull-requests.md b/docs/05-working-with-pull-requests.md
@@ -218,7 +218,7 @@ A PR page has three main tabs:
 [ Conversation ] [ Commits ] [ Files changed ]
                                 ↑ tab bar landmark
 
-─── Conversation Tab ────────────────────────────────────────
+--- Conversation Tab ----------------------------------------
 [PR description - authored by opener]
 [Status checks summary]
 [Activity / review thread]
@@ -227,11 +227,11 @@ A PR page has three main tabs:
 [Merge controls (for maintainers)]
 [Comment box]
 
-─── Commits Tab ─────────────────────────────────────────────
+--- Commits Tab ---------------------------------------------
 [List of commits, grouped by date - h3 for dates]
 [Each commit as a list item with SHA, message, author]
 
-─── Files Changed Tab ────────────────────────────────────────
+--- Files Changed Tab ----------------------------------------
 [File filter search]
 [File tree (left panel)]
 [Diff for each file - each file is a heading]
diff --git a/docs/07-culture-etiquette.md b/docs/07-culture-etiquette.md
@@ -54,28 +54,28 @@ Before diving into communication norms, it helps to understand the workflow that
 
 ```text
 1. Create a branch
-   └─ Branch off main with a descriptive name
+   +- Branch off main with a descriptive name
       (e.g., fix/missing-alt-text, docs/update-contributing-guide)
 
 2. Make your changes and commit
-   └─ Work in small, logical commits with clear messages
+   +- Work in small, logical commits with clear messages
       Each commit should represent one coherent, complete change
 
 3. Open a Pull Request
-   └─ Share your work early - even as a Draft PR
+   +- Share your work early - even as a Draft PR
       Describe what you changed, why, and how to test it
       Link to the related issue (Closes #42)
 
 4. Discuss and review
-   └─ Reviewers leave feedback → you refine your work
+   +- Reviewers leave feedback → you refine your work
       This is collaborative, not adversarial
 
 5. Pass status checks
-   └─ Automated tests and linting must pass
+   +- Automated tests and linting must pass
       The project's quality gates exist to protect everyone
 
 6. Merge
-   └─ A maintainer merges your PR into main
+   +- A maintainer merges your PR into main
       The linked issue closes automatically
       Your contribution is now part of the project
 ```
diff --git a/docs/12-github-pull-requests-extension.md b/docs/12-github-pull-requests-extension.md
@@ -192,15 +192,15 @@ gh pr list --search "review-requested:@me"
 
 ```text
 GitHub Pull Requests
-├── My Pull Requests
-│   ├── Assigned to Me
-│   ├── Created by Me
-│   ├── Waiting for my Review
-│   └── All Open
-├── [Repository Name]
-│   ├── Local Pull Request Branches (checked out locally)
-│   ├── All Open Pull Requests
-│   └── All Closed Pull Requests
++-- My Pull Requests
+|   +-- Assigned to Me
+|   +-- Created by Me
+|   +-- Waiting for my Review
+|   +-- All Open
++-- [Repository Name]
+|   +-- Local Pull Request Branches (checked out locally)
+|   +-- All Open Pull Requests
+|   +-- All Closed Pull Requests
 ```
 
 #### Screen reader announcement example
diff --git a/docs/15-issue-templates.md b/docs/15-issue-templates.md
@@ -195,13 +195,13 @@ Templates live in a specific folder in your repository:
 
 ```text
 your-repo/
-└── .github/
-    ├── ISSUE_TEMPLATE/
-    │   ├── bug_report.md         ← Markdown template
-    │   ├── feature_request.md    ← Markdown template
-    │   ├── accessibility-bug.yml ← YAML form template
-    │   └── config.yml            ← Template chooser configuration
-    └── pull_request_template.md  ← PR template (singular)
++-- .github/
+    +-- ISSUE_TEMPLATE/
+    |   +-- bug_report.md         ← Markdown template
+    |   +-- feature_request.md    ← Markdown template
+    |   +-- accessibility-bug.yml ← YAML form template
+    |   +-- config.yml            ← Template chooser configuration
+    +-- pull_request_template.md  ← PR template (singular)
 ```
 
 **Markdown templates (`.md`):** Traditional template format. Pre-fills a text editor with structured Markdown content. Contributors edit the template directly, replacing instructions and placeholder text with their own content.
diff --git a/docs/appendix-i-github-projects.md b/docs/appendix-i-github-projects.md
@@ -442,14 +442,14 @@ The **`/project-status`** command from Accessibility Agents gives you a live pro
 GitHub Project: Accessibility Agents Roadmap (3 active views)
 
 Column Breakdown:
-┌─────────────┬───────┬──────────────────┬─────────┬──────────────┐
-│ Column      │ Items │ Assignees        │ Avg Age │ Stale (7d+) │
-├─────────────┼───────┼──────────────────┼─────────┼──────────────┤
-│ To Do       │   8   │ @alice(3),@bob(2) │ 5 days  │     1       │
-│ In Progress │   4   │ @charlie(2)       │ 3 days  │     0       │
-│ In Review   │   2   │ --               │ 2 days  │     0       │
-│ Done        │  23   │ --               │  --     │    --       │
-└─────────────┴───────┴──────────────────┴─────────┴──────────────┘
++-------------+-------+------------------+---------+--------------+
+| Column      | Items | Assignees        | Avg Age | Stale (7d+) |
++-------------+-------+------------------+---------+--------------+
+| To Do       |   8   | @alice(3),@bob(2) | 5 days  |     1       |
+| In Progress |   4   | @charlie(2)       | 3 days  |     0       |
+| In Review   |   2   | --               | 2 days  |     0       |
+| Done        |  23   | --               |  --     |    --       |
++-------------+-------+------------------+---------+--------------+
 
 Attention Items:
   Stale: "Update screen reader navigation guide" - In Review for 9 days, no activity
diff --git a/docs/appendix-m-vscode-accessibility-reference.md b/docs/appendix-m-vscode-accessibility-reference.md
@@ -177,15 +177,15 @@ The Accessible Diff Viewer presents file diffs as a structured, line-by-line lis
 
 ```text
 Accessible Diff Viewer
-├── Header (file path, change summary)
-├── Hunk 1 of N
-│   ├── Hunk location (line range)
-│   ├── Unchanged lines (context)
-│   ├── Modified/Added/Removed lines (with prefix)
-│   └── More unchanged lines (context)
-├── Hunk 2 of N
-│   └── ...
-└── Footer (totals: X additions, Y deletions)
++-- Header (file path, change summary)
++-- Hunk 1 of N
+|   +-- Hunk location (line range)
+|   +-- Unchanged lines (context)
+|   +-- Modified/Added/Removed lines (with prefix)
+|   +-- More unchanged lines (context)
++-- Hunk 2 of N
+|   +-- ...
++-- Footer (totals: X additions, Y deletions)
 ```
 
 #### Line prefixes
diff --git a/docs/appendix-q-github-actions-workflows.md b/docs/appendix-q-github-actions-workflows.md
@@ -57,12 +57,12 @@ Workflow files live in a specific, mandatory location:
 
 ```text
 your-repository/
-└── .github/
-    └── workflows/
-        ├── ci.yml              ← Runs tests on every push/PR
-        ├── lint.yml            ← Checks code style
-        ├── a11y-scan.yml       ← Accessibility scanning
-        └── deploy.yml          ← Deploys the site when code merges to main
++-- .github/
+    +-- workflows/
+        +-- ci.yml              ← Runs tests on every push/PR
+        +-- lint.yml            ← Checks code style
+        +-- a11y-scan.yml       ← Accessibility scanning
+        +-- deploy.yml          ← Deploys the site when code merges to main
 ```
 
 The `.github/` folder is hidden by convention (starts with a dot). To find it:
