Skip to content

docs: Let Release Please write the changelog - #82

Merged
ThoreKoritzius merged 1 commit into
mainfrom
docs/fold-0.1.0-notes
Nov 12, 2026
Merged

ThoreKoritzius merged 1 commit into
mainfrom
docs/fold-0.1.0-notes

Conversation

@ThoreKoritzius

@ThoreKoritzius ThoreKoritzius commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

Releases should need nothing but merging the release PR. The hand-written [Unreleased] list got in the way:

  • Release Please never reads that list.
  • Its header pattern (\n###? v?[0-9[], updaters/changelog.ts) matches the [ in ## [Unreleased], so it inserts every version above that list.

So each release needed the notes folded in by hand. For 0.1.0 that didn't happen, and #83 (0.2.0) would repeat it.

Now Release Please alone writes CHANGELOG.md, as it does out of the box:

  • CHANGELOG.md:
    • The 0.1.0 notes become the 0.1.0 section, with one Added, Changed and Fixed list (the old list had Changed four times and Fixed twice). There are 69 entries, with their text unchanged.
    • The 14 generated 0.1.0 bullets are dropped, because each has a fuller entry; they stay in the v0.1.0 GitHub Release.
    • [Unreleased] is gone, along with the three hand-written 2D map entries, which chore(main): release 0.2.0 #83's generated 0.2.0 line covers.
    • The header says the file is generated from PR titles. Release Please's pattern now finds ## 0.1.0 first, so each new release lands on top.
  • PR template, AGENTS.md, docs/releases.md, ADR 0017: no more changelog entries by hand. The Conventional Commit PR title is the release note, so reviewers check the title.

After merging, Release Please regenerates #83, and releasing 0.2.0 is just merging it. make check passes.

🤖 Generated with Claude Code

The hand-written [Unreleased] list never reached a release: Release
Please doesn't read it, and inserts each version above it (its header
pattern matches the "["), so every release needed the notes folded in by
hand. Now Release Please alone writes CHANGELOG.md from the Conventional
Commit PR titles, as it does out of the box: the 0.1.0 notes become the
0.1.0 section (one Added, Changed and Fixed list), [Unreleased] is gone,
and the PR template, AGENTS.md, docs/releases.md and ADR 0017 say the PR
title is the release note.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ThoreKoritzius ThoreKoritzius changed the title docs: Fold the 0.1.0 notes into their release section docs: Let Release Please write the changelog Nov 12, 2026
@ThoreKoritzius
ThoreKoritzius merged commit 8ab2aff into main Nov 12, 2026
8 checks passed
@ThoreKoritzius
ThoreKoritzius deleted the docs/fold-0.1.0-notes branch November 12, 2026 06:29
ThoreKoritzius added a commit that referenced this pull request Nov 12, 2026
The PR title is the release note now (#82).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
ThoreKoritzius added a commit that referenced this pull request Nov 12, 2026
…andscape (#79)

* fix: Lay out the phone ride screen without overlaps in portrait and landscape

Panels that stacked on the top buttons or on each other (broadcast bar,
training chip and band, studio cue/targets/controls, workout stats, paddle
hint, milestone banner, race row beside the simulator stepper) now share
one grid of 44px rows with 8px gaps. The lane buttons become see-through.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* fix: Keep the landscape training targets clear of the left lane button

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* fix(client): Address the review of the phone ride layout

- Restore the closing brace of the narrow-screen Strava block that the
  rebase onto main dropped: the whole phone block had ended up inside
  @media (max-width: 380px) and applied to almost no phone.
- One rule each for .band and .band-stats in the landscape block, with
  the values that applied before (156px side columns, stats two to a row).
- The see-through lane buttons are for phones only; larger screens keep
  their buttons.
- In landscape the race row sits in the first row under the buttons, and
  only moves below the simulator stepper while that is shown.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: Leave the changelog to Release Please

The PR title is the release note now (#82).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(client): Give the phone HUD's status pills one home and readable glass

An audit of 40 phone screens (360 to 430 wide, upright and landscape,
four ride layouts) found:
- The drafting pill was white on light blue: 1.3:1 against the sky. It
  now uses the pills' dark glass with a blue edge and dot (everywhere).
- The status pills sat in the top row in landscape (over Riders/Pause)
  and under the buttons upright, behind the broadcast bar or the workout
  chip. On phones they now sit centred one row under the lowest top panel
  of each layout, and the milestone banner below them.
- Phones get slightly denser glass (0.82), so captions such as Workout
  and W/kg pass 4.5:1 in front of a bright sky.
- Short upright phones in training: a 190px band, the targets above it
  and the stepper beside the status row (lane buttons were on the band).
- Landscape race: the lane buttons start under the race row.
- Broadcast: W/kg stays one line in the power cell.
- Small landscape phones (≤760 wide) show the training band's side stats
  again; the narrow-screen rule had hidden them and squeezed the chart.

No overlaps remain in any of the 40 screens.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(client): One type scale on the phone ride screen

The phone ride screen used 21 font sizes; it now uses one scale:
12 captions, 13 buttons and units, 16 text, 18 emphasis, 24/26 and 28/32
numbers (upright/landscape), 40 big numbers, 54 the hero number. Sizes in
between snap to the nearest step (10, 14, 15, 17, 25.3, 36, 44, 68); the
milestone banner is 18/24 instead of following the viewport width.

The landscape training band gets 196px side columns, so its stats stay
on one line at 12px. The "bot" tag on name labels is an outline on the
label's dark glass instead of a light fill (4.4:1 → about 7:1).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(client): Fit the phone ride screen into real browser heights

On a real Android emulator, Chrome's address bar leaves 914x331 in
landscape and 411x834 upright: lower than the phone screens the layout
was checked on. The audit now also covers browser heights down to
640x280 and 360x560 (56 screens), and none has overlaps:
- The "race in progress, you are free riding" pill is gone on phones: it
  took a whole row and repeated the route profile's line; the status row
  keeps live riding feedback (drafting, best lap, group gap).
- Short landscape (≤360px), training: a 112px band, and the status pills
  move onto the targets' row, to the right.
- Small upright browsers (≤600px), training: a 150px band, the lane
  buttons on the targets' row; race: the stepper under the race rows and
  the lane buttons under it.
- Tiny landscape (≤300px), training: one-line targets, shorter lane
  buttons.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(client): Stack the phone HUD's notices and centre the cockpit

On the emulator and in an audit with every notice showing at once (72
screens, phones to laptops), the phone ride screen still had:
- Notices with fixed places of their own (status pills, junction, race
  and event calls, sprint/KOM countdown, splits, milestones) that ran
  into each other and into the race rows. They now sit in one wrapper:
  on large screens it makes no box and nothing moves; on phones it is a
  centred column under the top panels, between the side rails, with the
  live pills and one notice at a time (the most urgent). In landscape
  training and race the column keeps clear of the targets and the race
  boxes; small screens leave out what doesn't fit (race calls in a
  workout, notices but pills and junctions below 300px).
- A gauge off centre: the cluster's sides now share one width, so the
  power sits exactly in the middle (also on large screens).
- A hard band under the cockpit numbers: the scrim stopped at the HUD's
  safe-area inset. It now reaches the screen's edge and fades on an
  eased curve.
- A race row that said "No race running" during a race I'm not in, with
  room for a progress bar it didn't draw. It shows the race's status,
  and the bar only while I race (raceCaption, tested).
- Lane buttons on the cockpit numbers on short upright phones, and on
  the race boxes in short landscape.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
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