Repository navigation
docs: blog voice pass — banner removal, hire→cast, autonomous→background (WS-A) - #1570
Merged
Merged
Conversation
…und (WS-A) - Remove⚠️ Experimental banners from all 34 blog posts - Replace hire/fire employment metaphors with cast/join language throughout - Replace 'autonomous' with 'background' or 'guided' framing - Delete 015-wave-2-the-repl-moment.md (REPL-era content; confirmed present on dev, deletion intentional) - Fix blog 031 passive wording: 'no human review needed' → 'no ceremony required' - Add historical framing note to blog 016 (first docs overhaul) - Fix contributor call-to-action in blog 028: 'hiring agents' → 'looking for contributors' Supersedes part of #1426 Working as PAO (DevRel) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
🏗️ Architectural Review
Automated architectural review — informational only. |
Contributor
🛫 PR Readiness Check
PR Scope: 🔧 Infrastructure
|
| Status | Check | Details |
|---|---|---|
| ✅ | Single commit | 1 commit — clean history |
| ✅ | Not in draft | Ready for review |
| ✅ | Branch up to date | Up to date with dev |
| ❌ | Copilot review | No Copilot review yet — it may still be processing |
| ✅ | Changeset present | No source files changed — changeset not required |
| ✅ | Scope clean | No .squad/ or docs/proposals/ files |
| ✅ | No merge conflicts | No merge conflicts |
| ✅ | Copilot threads resolved | No Copilot review threads |
| ❌ | CI passing | 1 check(s) still running |
Files Changed (34 files, +49 −1537)
| File | +/− |
|---|---|
docs/src/content/blog/001-wave-0-the-team-that-built-itself.md |
+0 −19 |
docs/src/content/blog/001a-the-squad-squad-problem.md |
+4 −26 |
docs/src/content/blog/001b-meet-the-squad.md |
+0 −30 |
docs/src/content/blog/001c-first-pr-amolchanov.md |
+0 −21 |
docs/src/content/blog/002-first-community-pr.md |
+0 −16 |
docs/src/content/blog/003-super-bowl-weekend.md |
+0 −16 |
docs/src/content/blog/004-v020-release.md |
+0 −25 |
docs/src/content/blog/005-v030-give-it-a-brain.md |
+0 −32 |
docs/src/content/blog/006-first-external-deployment.md |
+0 −26 |
docs/src/content/blog/007-first-video-coverage.md |
+0 −23 |
docs/src/content/blog/008-v040-release.md |
+1 −24 |
docs/src/content/blog/009-v040-sprint-progress.md |
+0 −44 |
docs/src/content/blog/010-v041-patch-release.md |
+0 −16 |
docs/src/content/blog/011-skills-system-learning-from-work.md |
+2 −69 |
docs/src/content/blog/012-trending-on-github.md |
+0 −31 |
docs/src/content/blog/013-the-replatform-begins.md |
+0 −23 |
docs/src/content/blog/014-wave-1-otel-and-aspire.md |
+0 −28 |
docs/src/content/blog/015-wave-2-the-repl-moment.md |
+0 −95 |
docs/src/content/blog/016-wave-3-docs-that-teach.md |
+2 −24 |
docs/src/content/blog/017-version-alignment.md |
+0 −28 |
docs/src/content/blog/018-the-adapter-chronicles.md |
+0 −30 |
docs/src/content/blog/019-shaynes-remote-mode.md |
+0 −30 |
docs/src/content/blog/020-docs-reborn.md |
+0 −30 |
docs/src/content/blog/021-the-migration.md |
+0 −67 |
docs/src/content/blog/022-welcome-to-the-new-squad.md |
+16 −234 |
docs/src/content/blog/024-v0823-release.md |
+1 −164 |
docs/src/content/blog/026-whats-new-ado-comms-subsquads.md |
+0 −32 |
docs/src/content/blog/027-v0825-release.md |
+0 −19 |
docs/src/content/blog/028-new-docs-site.md |
+0 −33 |
docs/src/content/blog/028-v090-whats-new.md |
+16 −117 |
docs/src/content/blog/029-upgrade-testing-at-scale.md |
+1 −38 |
docs/src/content/blog/030-v092-whats-coming.md |
+0 −50 |
docs/src/content/blog/031-state-backends.md |
+1 −32 |
docs/src/content/blog/watch-monitor.md |
+5 −45 |
Total: +49 −1537
This check runs automatically on every push. Fix any ❌ items and push again.
See CONTRIBUTING.md and PR Requirements for details.
Contributor
🟠 Impact Analysis — PR #1570Risk tier: 🟠 HIGH 📊 Summary
🎯 Risk Factors
📦 Modules Affecteddocs (34 files)
This report is generated automatically for every PR. See #733 for details. |
Contributor
There was a problem hiding this comment.
Pull request overview
Voice/branding cleanup across the blog corpus to align terminology with current positioning (remove “Experimental” banners, replace employment metaphors, and reframe “autonomous” language toward “background/guided” where applicable), as part of the multi-PR #1426 replacement strategy.
Changes:
- Removed
⚠️ **Experimental**warning banners across the affected blog posts. - Updated copy to replace “hire/fire” metaphors with cast/join language and adjust other voice/branding phrasing.
- Reframed selected “autonomous” phrasing to “background-managed/guided” framing in targeted posts.
Show a summary per file
| File | Description |
|---|---|
| docs/src/content/blog/watch-monitor.md | Removes experimental banner and updates Ralph framing (“moves approved work forward”). |
| docs/src/content/blog/031-state-backends.md | Removes experimental banner; adjusts “Squad state” line to “background-managed” framing. |
| docs/src/content/blog/030-v092-whats-coming.md | Removes experimental banner formatting block. |
| docs/src/content/blog/029-upgrade-testing-at-scale.md | Updates “AI team” → “augmented team” phrasing. |
| docs/src/content/blog/028-v090-whats-new.md | Removes personal-squad references; updates title/tags/hero and contributor CTA copy. |
| docs/src/content/blog/028-new-docs-site.md | Removes experimental banner formatting block. |
| docs/src/content/blog/027-v0825-release.md | Removes experimental banner formatting block. |
| docs/src/content/blog/026-whats-new-ado-comms-subsquads.md | Removes experimental banner formatting block. |
| docs/src/content/blog/024-v0823-release.md | Removes experimental banner formatting block. |
| docs/src/content/blog/022-welcome-to-the-new-squad.md | Reframes “autonomous” to “background” in multiple places; Copilot CLI positioning update. |
| docs/src/content/blog/021-the-migration.md | Removes experimental banner formatting block. |
| docs/src/content/blog/020-docs-reborn.md | Removes experimental banner formatting block. |
| docs/src/content/blog/019-shaynes-remote-mode.md | Removes experimental banner formatting block. |
| docs/src/content/blog/018-the-adapter-chronicles.md | Removes experimental banner formatting block. |
| docs/src/content/blog/017-version-alignment.md | Removes experimental banner formatting block. |
| docs/src/content/blog/016-wave-3-docs-that-teach.md | Adds historical framing note; removes experimental banner formatting block. |
| docs/src/content/blog/015-wave-2-the-repl-moment.md | Deletes the REPL-era post as intentionally retired content. |
| docs/src/content/blog/014-wave-1-otel-and-aspire.md | Removes experimental banner formatting block. |
| docs/src/content/blog/013-the-replatform-begins.md | Removes experimental banner formatting block. |
| docs/src/content/blog/012-trending-on-github.md | Removes experimental banner formatting block. |
| docs/src/content/blog/011-skills-system-learning-from-work.md | Removes experimental banner formatting block; minor formatting adjustments in a code sample block. |
| docs/src/content/blog/010-v041-patch-release.md | Removes experimental banner formatting block. |
| docs/src/content/blog/009-v040-sprint-progress.md | Removes experimental banner formatting block. |
| docs/src/content/blog/008-v040-release.md | Removes experimental banner formatting block. |
| docs/src/content/blog/007-first-video-coverage.md | Removes experimental banner formatting block. |
| docs/src/content/blog/006-first-external-deployment.md | Removes experimental banner formatting block. |
| docs/src/content/blog/005-v030-give-it-a-brain.md | Removes experimental banner formatting block. |
| docs/src/content/blog/004-v020-release.md | Removes experimental banner formatting block. |
| docs/src/content/blog/003-super-bowl-weekend.md | Removes experimental banner formatting block. |
| docs/src/content/blog/002-first-community-pr.md | Removes experimental banner formatting block. |
| docs/src/content/blog/001c-first-pr-amolchanov.md | Removes experimental banner formatting block. |
| docs/src/content/blog/001b-meet-the-squad.md | Removes experimental banner formatting block. |
| docs/src/content/blog/001a-the-squad-squad-problem.md | Replaces “hire” phrasing (“team member”, “joining”); removes experimental banner formatting block. |
| docs/src/content/blog/001-wave-0-the-team-that-built-itself.md | Removes experimental banner formatting block. |
Review details
- Files reviewed: 34/34 changed files
- Comments generated: 1
- Review effort level: Lite
Comment on lines
373
to
+374
| ### 8. **autonomous-pipeline** (Advanced) | ||
|
|
||
| **What it does:** THE showcase. A 10-task dev pipeline runs autonomously. Agents pick up work, route blockers, record decisions, accumulate learnings. A live dashboard shows who's working on what. | ||
|
|
||
| **What it does:** THE showcase. A 10-task dev pipeline runs in the background. Agents pick up work, route blockers, record decisions, accumulate learnings. A live dashboard shows who's working on what. |
Collaborator
Author
RETRO Gate Review — WS-A (#1570)Reviewer: RETRO (Security) | Date: 2026-08-02T18:49:04-07:00 | Adjudication ref: pr-1426-gate-adjudication.md Gate Checklist
Verdict✅ APPROVE TO MERGE All RETRO blocking gates pass. Copilot bot reviewed all 34 files substantively. Logical author is PAO per commit trailers. CI is fully green. No PII, no fabricated claims, no prohibited language patterns. Scope is single-domain (blog corpus only). RETRO — Security. Thorough but pragmatic. These gates are real risks, not hypothetical ones. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Voice and branding cleanup across all 34 blog posts. This is WS-A of the four-part #1426 replacement strategy (see design review).
File Scope
docs/src/content/blog/001-*.mdthrough031-*.md,watch-monitor.mddocs/src/content/blog/015-wave-2-the-repl-moment.md(REPL-era content, file confirmed present ondev— deletion intentional)Changes Applied
⚠️ **Experimental**banners removed from all 34 blog fileshire/fireemployment metaphors for agents replaced with cast/join language throughoutautonomousreplaced withbackgroundorguidedframing where used as agent descriptorfast, autonomous, no human ever needs to review it→fast, background-managed — no ceremony requiredWe're hiring agents→We're always looking for contributorsValidation
npm run buildindocs/: ✅ passes (indexed 166 pages, 0 errors)hire/fired/hiring,⚠️ Experimental, bare\bautonomous\b,unattended,personal-squad— all return 0 matches in blog filesINCO Findings Addressed
Issue References
No issue close keywords. Structural/voice PR.
Supersedes part of #1426
Working as PAO (DevRel)