feat: Created 198-line Newcomer-Guide.md with 8 sections covering full…

- "Newcomer-Guide.md"

GSD-Task: S11/T02
This commit is contained in:
jlightner 2026-04-04 15:35:39 +00:00
parent e77f8e0fea
commit 64c0a47816
3 changed files with 108 additions and 1 deletions

View file

@ -61,7 +61,7 @@ Content sources are the S01-S10 slice summaries from M025. The research doc iden
- Estimate: 45m - Estimate: 45m
- Files: Home.md (on ub01 wiki clone), API-Surface.md, Data-Model.md, Frontend.md, Configuration.md, Chat-Engine.md, Deployment.md, Decisions.md, _Sidebar.md, Architecture.md - Files: Home.md (on ub01 wiki clone), API-Surface.md, Data-Model.md, Frontend.md, Configuration.md, Chat-Engine.md, Deployment.md, Decisions.md, _Sidebar.md, Architecture.md
- Verify: ssh ub01 'cd /tmp/chrysopedia-wiki-m025 && git log --oneline -1' shows M025 commit AND ssh ub01 'cd /tmp/chrysopedia-wiki-m025 && git diff HEAD~1 --stat' shows ~10 files changed - Verify: ssh ub01 'cd /tmp/chrysopedia-wiki-m025 && git log --oneline -1' shows M025 commit AND ssh ub01 'cd /tmp/chrysopedia-wiki-m025 && git diff HEAD~1 --stat' shows ~10 files changed
- [ ] **T02: Create Newcomer Guide and push all wiki changes** — Create the Newcomer-Guide.md page — the primary deliverable of this slice — and push all wiki changes (both T01 updates and this new page) to the Forgejo wiki. - [x] **T02: Created 198-line Newcomer-Guide.md with 8 sections covering full Chrysopedia platform and pushed all wiki changes to Forgejo — wiki now has 21 pages** — Create the Newcomer-Guide.md page — the primary deliverable of this slice — and push all wiki changes (both T01 updates and this new page) to the Forgejo wiki.
**CRITICAL:** Never use the Forgejo wiki PATCH API — it corrupts pages. Only use git push. **CRITICAL:** Never use the Forgejo wiki PATCH API — it corrupts pages. Only use git push.

View file

@ -0,0 +1,30 @@
{
"schemaVersion": 1,
"taskId": "T01",
"unitId": "M025/S11/T01",
"timestamp": 1775316768794,
"passed": false,
"discoverySource": "task-plan",
"checks": [
{
"command": "ssh ub01 'cd /tmp/chrysopedia-wiki-m025",
"exitCode": 2,
"durationMs": 9,
"verdict": "fail"
},
{
"command": "git log --oneline -1' shows M025 commit AND ssh ub01 'cd /tmp/chrysopedia-wiki-m025",
"exitCode": 128,
"durationMs": 11,
"verdict": "fail"
},
{
"command": "git diff HEAD~1 --stat' shows ~10 files changed",
"exitCode": 2,
"durationMs": 10,
"verdict": "fail"
}
],
"retryAttempt": 1,
"maxRetries": 2
}

View file

@ -0,0 +1,77 @@
---
id: T02
parent: S11
milestone: M025
provides: []
requires: []
affects: []
key_files: ["Newcomer-Guide.md"]
key_decisions: []
patterns_established: []
drill_down_paths: []
observability_surfaces: []
duration: ""
verification_result: "grep -c "^## " Newcomer-Guide.md returns 8 (≥8 requirement). Wiki API page count returns 21 (≥21 requirement). git log shows both M025 commits pushed. File exists with 198 lines."
completed_at: 2026-04-04T15:35:28.620Z
blocker_discovered: false
---
# T02: Created 198-line Newcomer-Guide.md with 8 sections covering full Chrysopedia platform and pushed all wiki changes to Forgejo — wiki now has 21 pages
> Created 198-line Newcomer-Guide.md with 8 sections covering full Chrysopedia platform and pushed all wiki changes to Forgejo — wiki now has 21 pages
## What Happened
---
id: T02
parent: S11
milestone: M025
key_files:
- Newcomer-Guide.md
key_decisions:
- (none)
duration: ""
verification_result: passed
completed_at: 2026-04-04T15:35:28.620Z
blocker_discovered: false
---
# T02: Created 198-line Newcomer-Guide.md with 8 sections covering full Chrysopedia platform and pushed all wiki changes to Forgejo — wiki now has 21 pages
**Created 198-line Newcomer-Guide.md with 8 sections covering full Chrysopedia platform and pushed all wiki changes to Forgejo — wiki now has 21 pages**
## What Happened
Created Newcomer-Guide.md on ub01 with 8 sections as specified: What is Chrysopedia, How Content Flows (6-stage pipeline), Using the Web UI (search, browse, technique pages, chat), For Creators (onboarding, consent, dashboard, transparency, export, notifications, personality profiles), For Admins (review queue, pipeline admin, usage dashboard, audit log, user management), Adding New Content (transcript prep through quality control), Infrastructure & Deployment (Docker Compose service table), Where to Learn More (cross-reference table to all 17 wiki pages). Pushed both T01's 10-page update commit and T02's new page commit to Forgejo origin.
## Verification
grep -c "^## " Newcomer-Guide.md returns 8 (≥8 requirement). Wiki API page count returns 21 (≥21 requirement). git log shows both M025 commits pushed. File exists with 198 lines.
## Verification Evidence
| # | Command | Exit Code | Verdict | Duration |
|---|---------|-----------|---------|----------|
| 1 | `ssh ub01 'curl -s .../wiki/pages?limit=50 | python3 ...'` | 0 | ✅ pass — 21 pages | 2000ms |
| 2 | `ssh ub01 'cd /tmp/chrysopedia-wiki-m025 && test -f Newcomer-Guide.md && grep -c "^## " Newcomer-Guide.md'` | 0 | ✅ pass — 8 sections | 1000ms |
| 3 | `ssh ub01 'cd /tmp/chrysopedia-wiki-m025 && git log --oneline -3'` | 0 | ✅ pass — both M025 commits visible | 1000ms |
| 4 | `ssh ub01 'cd /tmp/chrysopedia-wiki-m025 && git push'` | 0 | ✅ pass — pushed to origin/main | 3000ms |
## Deviations
None. Previous verification failures were malformed shell commands in the gate, not content issues.
## Known Issues
None.
## Files Created/Modified
- `Newcomer-Guide.md`
## Deviations
None. Previous verification failures were malformed shell commands in the gate, not content issues.
## Known Issues
None.