From f042d2de13b5900259c0e3078ebfd4b68523803e Mon Sep 17 00:00:00 2001
From: Josh Bruce <josh@8fold.pro>
Date: Thu, 15 Oct 2026 13:53:11 -0400
Subject: [PATCH] Complete 5.0 migration details and correct release checklist

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
---
 .github/PULL_REQUEST_TEMPLATE/release.md |  4 ++--
 README.md                                | 16 ++++++++++++----
 2 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE/release.md b/.github/PULL_REQUEST_TEMPLATE/release.md
index 024cde8..caa136c 100644
--- a/.github/PULL_REQUEST_TEMPLATE/release.md
+++ b/.github/PULL_REQUEST_TEMPLATE/release.md
@@ -1,9 +1,9 @@
 ## Publisher
 
-- [ ] Release notes in [draft GitHub release](https://github.com/8fold/laravel-provider/releases) are up to date?
+- [ ] Release notes in [draft GitHub release](https://github.com/8fold/php-html-builder/releases) are up to date?
 - [ ] Committer checklist is complete.
 - [ ] Merge PR.
-- [ ] Publish GitHub release using `master` with correct version number.
+- [ ] Publish GitHub release using `main` with correct version number.
 - [ ] Create draft GitHub release to prepare next release.
 
 ## Committer
diff --git a/README.md b/README.md
index 496c407..7dfbc3a 100644
--- a/README.md
+++ b/README.md
@@ -84,23 +84,24 @@ apply to the new and existing APIs.
 ### Required migration checks: markup and property targets
 
 Text-entry controls now render an outer `<div>` unconditionally. In 4.4.0,
-`TextInput` and `EmailInput` rendered their label and input as siblings without
+`TextInput`, `EmailInput`, and `Password` rendered their label and input as siblings without
 that container. Update CSS child/sibling selectors, flex or grid layouts, and
 JavaScript traversal that assumed the old structure.
 
 ```html
 <!-- 4.4.0 -->
-<label for="email">Email</label><input id="email" name="email" type="text" value="">
+<label for="email">Email</label><input id="email" name="email" type="text">
 
 <!-- 5.0 -->
 <div class="field">
-  <label for="email">Email</label><input id="email" name="email" type="text" value="">
+  <label for="email">Email</label><input id="email" name="email" type="text">
 </div>
 ```
 
 Use each property method for its element: `containerProps()` targets the outer
 container, `labelProps()` targets the label (or a Select group's legend), and
-`inputProps()` targets the input or select. For example:
+`inputProps()` targets the input, textarea, or select. Fieldset's `labelProps()`
+targets its legend. For example:
 
 ```php
 use Eightfold\HtmlBuilder\Forms\TextInput;
@@ -140,6 +141,13 @@ ignored; use the selection argument and mode methods instead. See
 [Select attributes and selection](#select-attributes-and-selection) for native
 attribute targets and examples.
 
+Radio and checkbox member IDs now use `<control-id>-option-<zero-based-index>`
+instead of `<name>-<option-value>`. For example, option `a` in a group named
+`categories` changes from `categories-a` to `categories-option-0`. Generated
+labels follow the new IDs automatically; update external labels, CSS selectors,
+and JavaScript that reference the old IDs. `id()` changes the group's member-ID
+prefix, not its submitted name.
+
 ### Update custom PropertyInterface implementations
 
 `PropertyInterface` now extends PHP's `Stringable`. Any custom implementation