justin/ai-workflow-course
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

De-slop the syllabus and the blog (em-dashes + banned words) (#96)

Browse Source 
Co-authored-by: claude <claude@jpaul.io>
Co-committed-by: claude <claude@jpaul.io>
This commit was merged in pull request #96.
This commit is contained in:
Claude (agent)
2026-06-23 07:28:55 -04:00
committed by Claude (agent)
parent 66c15800c3
commit 863435915c
19 changed files with 622 additions and 622 deletions
Download Patch File Download Diff File Expand all files Collapse all files
blog/README.md
+10 -10
View File
@@ -1,7 +1,7 @@
# Blog posts (jpaul.me)
Drafts of blog posts for **jpaul.me** that promote and add value around *The Workflow*
course. **This folder is not course content** — it lives here only so the drafts are
course. **This folder is not course content**; it lives here only so the drafts are
version-controlled alongside the material they describe. Pull it out before any public
GitHub mirror push if you don't want the drafts shipped publicly.
@@ -9,15 +9,15 @@ GitHub mirror push if you don't want the drafts shipped publicly.
- One Markdown file per post, numbered in intended publish order: `NN-slug.md`.
- Each file opens with a metadata block (suggested title, slug, meta description, tags)
for easy paste into WordPress — delete it before publishing or keep it as notes.
for easy paste into WordPress; delete it before publishing or keep it as notes.
- Screenshots are left as `[insert a screenshot referencing XYZ here]` placeholders for
Justin to fill before publishing.
- Voice: conversational, first-person, value-first. Course link is a soft CTA, not the
whole point — each post should stand on its own for a reader who never takes the course.
whole point; each post should stand on its own for a reader who never takes the course.
## Publishing cadence & manifest
**Structure:** announcement + getting-started, then a weekly series. Hybrid granularity —
**Structure:** announcement + getting-started, then a weekly series. Hybrid granularity:
one post per *module* for the durable core (Units 1–2), one post per *unit* for the
faster-moving back half (Units 3–5), plus a capstone finale. 17 posts total.
@@ -26,10 +26,10 @@ faster-moving back half (Units 3–5), plus a capstone finale. 17 posts total.
| 01 | `01-announcing-the-workflow.md` | Announcement / thesis | Your AI Already Writes Good Code. That's Not Your Problem. |
| 02 | `02-getting-started-the-copy-paste-problem.md` | Module 1 + setup | The Copy-Paste Problem (and How to Actually Get Started) |
| 03 | `03-version-control-safety-net.md` | Module 2 | Git Is Undo for the AI (and Memory It Can Read Back) |
| 04 | `04-version-control-for-words.md` | Module 3 | Version Control Isn't Just for Code — Start With Your Words |
| 05 | `05-getting-the-ai-out-of-the-browser.md` | Module 4 | Let the AI Edit Your Files (Yes, Really — Here's Why It's Safe) |
| 04 | `04-version-control-for-words.md` | Module 3 | Version Control Isn't Just for Code: Start With Your Words |
| 05 | `05-getting-the-ai-out-of-the-browser.md` | Module 4 | Let the AI Edit Your Files (Yes, Really: Here's Why It's Safe) |
| 06 | `06-commit-the-ai-config.md` | Module 5 | Commit the AI's Config, Not Just the Code |
| 07 | `07-branches-sandboxes.md` | Module 6 | Let the AI Try Something Reckless — On a Branch |
| 07 | `07-branches-sandboxes.md` | Module 6 | Let the AI Try Something Reckless, on a Branch |
| 08 | `08-worktrees-parallel-agents.md` | Module 7 | Stop Making Your Agents Take Turns: Git Worktrees |
| 09 | `09-remotes-and-hosting.md` | Module 8 | Your Repo Lives on One Disk. That's One Spilled Coffee From Gone. |
| 10 | `10-issues-task-layer.md` | Module 9 | Who Picks This Up? Writing Issues for a Team of Humans and Agents |
@@ -42,16 +42,16 @@ faster-moving back half (Units 3–5), plus a capstone finale. 17 posts total.
| 17 | `17-capstone-the-full-loop.md` | Capstone | The Full Loop: One Feature, End to End |
Each file's top-of-file HTML comment holds the suggested title, slug, meta description,
and tags for WordPress. Titles above are starting points — every post also carries an
and tags for WordPress. Titles above are starting points; every post also carries an
alt title in its metadata block.
## Before publishing — checklist
## Before publishing: checklist
- [x] `[COURSE LINK]` placeholders filled with the course URL
`https://git.jpaul.io/justin/ai-workflow-course`. At public launch: (a) if the GitHub
mirror becomes the public home, swap these to the mirror URL; (b) inline cross-post
references ("announcement post", "last post", "course lab") currently all point at the
course home — repoint them to the specific jpaul.me post URLs (or wiki module pages)
course home; repoint them to the specific jpaul.me post URLs (or wiki module pages)
once those exist.
- Fill every `[insert a screenshot referencing XYZ here]` placeholder with a real image.
- Decide whether to keep or strip the top-of-file metadata comment block.