avm/hassio-addons
1
0
Fork 0
mirror of https://github.com/alexbelgium/hassio-addons.git synced 2026-09-09 11:19:10 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs(skill): narrow the ISO claim and correct the grep description

Browse Source 
Review fixes. The bolded lead read as an absolute while the body reported 363
DD-MM-YYYY headings and told you to match the file — it now says "most", and
says outright that a DD-MM-YYYY file stays DD-MM-YYYY. The counts are stamped
as of 2026-08-25 so a future reader knows they are a snapshot.

CodeRabbit is right that `grep -q "^## ${version} ("` is not an exact-version
check. Reproduced: with version 5.1.1.2 the pattern matches a heading reading
`## 5X1Y1Z2 (`, because BRE dots match any character; `grep -qF` does not.
Described as an unescaped BRE instead. The conclusion is unchanged, since the
date is not in the pattern either way.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
alexbelgium
2026-08-25 15:53:31 +02:00
parent 138e7d7c33
commit 833d0d3758
1 changed files with 11 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
.claude/skills/hassio-addon-workflow/references/traps.md
View File

@@ -241,15 +241,17 @@ account. Note it and move on rather than guessing.
**Resolving a review thread requires GraphQL** (`resolveReviewThread`); the REST API cannot do it. **Resolving a review thread requires GraphQL** (`resolveReviewThread`); the REST API cannot do it.
`scripts/pr_review.sh` wraps fetch / reply / resolve. `scripts/pr_review.sh` wraps fetch / reply / resolve.
**CHANGELOG heading dates are ISO, whatever the bots' defaults say.** Match the format already in **Most CHANGELOG heading dates are ISO, whatever the bots' defaults say.** Match the format
the add-on's file. Repo-wide that is `## <version> (YYYY-MM-DD)`: 7705 dated headings against 363 already in the add-on's file — a `DD-MM-YYYY` file stays `DD-MM-YYYY`. Where you have no
in `DD-MM-YYYY`, and the newest entry is ISO in 125 of 135 add-ons. Copilot flags an ISO file that precedent, ISO is the house style: as of 2026-08-25, `## <version> (YYYY-MM-DD)` accounts for
gets a `DD-MM-YYYY` entry (#3019). `DD-MM-YYYY` is not invented — it is what `onpush_builder.yaml` 7705 dated headings against 363 in `DD-MM-YYYY`, and the newest entry is ISO in 125 of 135
writes with `date '+%d-%m-%Y'` when it has to insert a heading you forgot, and what the add-ons. Copilot flags an ISO file that gets a `DD-MM-YYYY` entry (#3019). `DD-MM-YYYY` is not
addons_updater bot writes when its `date_iso8601` option is off (`99-run.sh`; it is on in invented — it is what `onpush_builder.yaml` writes with `date '+%d-%m-%Y'` when it has to insert
production here) — but neither is a reason to write it yourself. The builder's duplicate check is a heading you forgot, and what the addons_updater bot writes when its `date_iso8601` option is
`grep -q "^## ${version} ("`, keyed on the exact `config.yaml` version and blind to the date, so off (`99-run.sh`; it is on in production here) — but neither is a reason to write it yourself.
an ISO heading you wrote yourself still suppresses the bot's insertion. The builder's duplicate check is `grep -q "^## ${version} ("` — an unescaped BRE, so the dots in
a version match any character, and it does not look at the date at all. Either way an ISO heading
you wrote yourself still suppresses the bot's insertion.
**The repo's `.markdownlint.yaml` does not disable MD022/MD032**, so a CHANGELOG will show **The repo's `.markdownlint.yaml` does not disable MD022/MD032**, so a CHANGELOG will show
dozens of pre-existing heading/list findings. They are noise because lint is `continue-on-error`, dozens of pre-existing heading/list findings. They are noise because lint is `continue-on-error`,