docs: thermal-model.md readable — sections and lists, same content - #18
Merged
Conversation
…same content Two 49- and 27-line paragraphs become titled sections (the model, segments vs sessions, ambient bracketing, the live forecast, the degradation watch's four sub-questions) with lists where the prose was enumerating. Every claim and number is preserved; two sentences are added to reflect what shipped since it was written — the calibrated idle offset replacing the ~2 °C constant, and the session-page hindsight line with its 'if this current holds' label. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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
1 participant
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.
Problem
docs/thermal-model.mdwas two wall-of-text paragraphs — 49 and 27 wrapped lines — covering a dozen distinct ideas (segment vs session fitting, ambient bracketing, cool-down-tail ambient, the live forecast's four states, current-band pooling, uncertainty, the baseline anchor, the scatter). Correct and complete, and very hard to scan.Code touched
docs/thermal-model.mdonly. Restructured into: What the charger does → The model → Segments, not sessions → Ambient is a bracket, not a point → The live forecast → Degradation watch with four sub-questions (what it compares, how sure it is, what it compares against, the confounder it can't remove). Enumerating prose became lists. Every claim, number, and API reference from the original is preserved.Two small content updates so the page matches what shipped: the idle-handle offset is now described as the calibrated ambient-dependent model (it said "~2 °C", the constant #5 retired), and a paragraph notes the session-page hindsight line and why it is labelled predicted plateau (if this current holds). Cross-links added to the ambient-sensing and amp-control pages.
Risk
None functional. The only semantic changes are the two updates above, both reflecting merged behavior.
Verification
Read side by side against the original for dropped content: none. Relative links (
ambient-sensors.md,amp-control.md,../README.md) resolve on GitHub; the README links to this page with an absolute URL as before.🤖 Generated with Claude Code