Skip to content

README as a getting-started guide, with new screenshots - #27

Merged
dben merged 5 commits into
mainfrom
claude/optimistic-curie-lflznu
Oct 25, 2026
Merged

dben merged 5 commits into
mainfrom
claude/optimistic-curie-lflznu

Conversation

@dben

@dben dben commented Oct 25, 2026

Copy link
Copy Markdown
Owner
  • Retake the screenshots from made-up podcasts run through the current
    app: the timeline (intro, ad breaks, a section cut by hand, outro), the
    home page, the episode list with a selection, and new ones for the
    Filters, Settings and Private feed tabs, captions and the phone layout.
  • Rewrite the README around installing and using pod-block: adding a
    podcast, downloading, checking the cuts, listening, filters, show
    settings and phrases, captions, and sharing.
  • Move block types, how repeats are found, speed and the database to a
    new HOW-IT-WORKS.md, and point CLI.md and WEBAPP.md at it.
  • Tone pass over CLI.md, WEBAPP.md and the deployment and whisper READMEs:
    rewrap uneven lines, untangle the Retention bullets, and correct how long
    captions outlast clean-up.

Co-Authored-By: Claude Opus 5.5 [email protected]
Claude-Session: https://claude.ai/code/session_015LKxkNWZNzhFwjch7F2M6A

- Retake the screenshots from made-up podcasts run through the current
  app: the timeline (intro, ad breaks, a section cut by hand, outro), the
  home page, the episode list with a selection, and new ones for the
  Filters, Settings and Private feed tabs, captions and the phone layout.
- Rewrite the README around installing and using pod-block: adding a
  podcast, downloading, checking the cuts, listening, filters, show
  settings and phrases, captions, and sharing.
- Move block types, how repeats are found, speed and the database to a
  new HOW-IT-WORKS.md, and point CLI.md and WEBAPP.md at it.
- Tone pass over CLI.md, WEBAPP.md and the deployment and whisper READMEs:
  rewrap uneven lines, untangle the Retention bullets, and correct how long
  captions outlast clean-up.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_015LKxkNWZNzhFwjch7F2M6A
- docs/screenshots/make/ retakes the README screenshots in one command
  (run.sh): made-up feeds, a stand-in transcriber, seeding the app, and
  the Playwright shots, about six minutes end to end.
- The hero show now has a segment theme (a plain Repeat), an ad read its
  feed's transcript leaves out (Not in transcript), and an outro cut at
  "This was a production of Podblock Studios" (Outro (phrase)).
- Captions and Settings shots move to that show, so they show speaker
  letters, the transcript check and the outro phrase.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_015LKxkNWZNzhFwjch7F2M6A
… list

- Add a contents list, and put the features first: each one (captions,
  phrases, the transcript check, chapters, the episode page, show
  settings, the Jobs, Downloads and Timings pages) gets its own section
  instead of a long bullet under Processing, with labelled bullets.
- Move Decisions, Stack, How it fits together, Code layout, Data model,
  Routes and the UI rules under Design.
- Future features, checked against the code and grouped by area; note
  what's already handled for bumpers and where captions' words are used.
- Fixes found on the way: 21 migrations, not 15; original_sha in the data
  model; GET /episodes/{id}/transcript and POST /downloads/reprocess in
  Routes; HOW-IT-WORKS.md's breaks use the show's longest ad break (8
  minutes by default, not 10) and handle false-start stings.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_015LKxkNWZNzhFwjch7F2M6A
With main's fix (#26) merged, the timeline and the Ready card say 7
sections for the hero episode. The captions shot now pauses part way into
a line, so the line being said is highlighted.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_015LKxkNWZNzhFwjch7F2M6A
@dben
dben merged commit 0142c71 into main Oct 25, 2026
5 checks passed
@dben
dben deleted the claude/optimistic-curie-lflznu branch October 25, 2026 13:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants