stm32lib: Add workflow documentation for updating vendor versions.

This adds a step-by-step guide for updating MCU series to new vendor versions,
making the vendor/work branch workflow more accessible.

The new section covers:
- Cloning/fetching upstream STM32Cube repositories
- Using fetch_from_upstream.sh to import vendor code
- Proper commit message format (tags are created by maintainers)
- Creating work branches and rebasing MicroPython patches
- Pushing and creating pull requests

Author: pi-anl

README.md

@@ -21,6 +21,83 @@ minor patches to the vendor code, for example work-F4-1.5.0+F7-1.1.0+L4-1.3.0.
 The patches/commits that form a given working branch are reapplied (with
 conflict resolution) to newer vendor tags to create the next working branch.
 
+Updating to a new vendor version
+=================================
+
+To update a specific MCU series (e.g. STM32WB) to a new vendor version, follow
+these steps:
+
+1. **Clone or fetch the upstream STM32Cube repository**
+
+   For example, to update STM32WB:
+   ```bash
+   git clone https://github.com/STMicroelectronics/STM32CubeWB.git
+   cd STM32CubeWB
+   git checkout v1.23.0  # or desired version
+   ```
+
+2. **Identify the current work branch before updating vendor**
+
+   Check the current vendor tag to identify which work branch corresponds to it:
+   ```bash
+   git describe --tags --exact-match origin/vendor
+   ```
+
+   This shows the current version tag, for example:
+   ```
+   F0-1.9.0+F4-1.16.0+F7-1.7.0+G0-1.5.1+G4-1.3.0+H5-1.0.0+H7-1.11.0+L0-1.11.2+L1-1.10.3+L4-1.17.0+N6-1.1.0+WB-1.10.0+WL-1.1.0
+   ```
+
+   Find the work branch that matches this tag:
+   ```bash
+   git branch -r | grep "origin/work-" | grep "WB-1.10.0"
+   ```
+
+   Now checkout vendor to begin the update:
+   ```bash
+   cd path/to/stm32lib
+   git checkout vendor
+   ```
+
+3. **Import and commit the vendor update**
+
+   ```bash
+   ./fetch_from_upstream.sh STM32WB path/to/STM32CubeWB
+   git add -A
+   git commit -m "Import STM32CubeWB v1.23.0 on DD-Mon-YYYY."
+   ```
+
+   The `fetch_from_upstream.sh` script will copy and process the new CMSIS and HAL
+   source files. The maintainer will create the version tag after merging.
+
+4. **Create new work branch and rebase patches**
+
+   Create a new work branch name by updating only the MCU series you're upgrading.
+   For example, updating WB from 1.10.0 to 1.23.0:
+   ```bash
+   # Old: origin/work-...-WB-1.10.0-...
+   # New: work-...-WB-1.23.0-...
+   git checkout -b work-F0-1.9.0+F4-1.16.0+F7-1.7.0+G0-1.5.1+G4-1.3.0+H5-1.0.0+H7-1.11.0+L0-1.11.2+L1-1.10.3+L4-1.17.0+N6-1.1.0+WB-1.23.0+WL-1.1.0 \
+       origin/work-F0-1.9.0+F4-1.16.0+F7-1.7.0+G0-1.5.1+G4-1.3.0+H5-1.0.0+H7-1.11.0+L0-1.11.2+L1-1.10.3+L4-1.17.0+N6-1.1.0+WB-1.10.0+WL-1.1.0
+   ```
+
+   Rebase all patches onto the updated vendor branch:
+   ```bash
+   git rebase vendor
+   ```
+
+   Resolve any conflicts if they arise. The rebase applies all MicroPython-specific
+   patches from the previous work branch onto the new vendor code.
+
+5. **Push and create pull request**
+
+   Push only the work branch (not vendor - the vendor commit will be included in the PR):
+   ```bash
+   git push -u fork work-F0-1.9.0+...+WB-1.23.0+...
+   gh pr create --repo micropython/stm32lib --base vendor \
+                --title "stm32lib: Update STM32WB from v1.10.0 to v1.23.0."
+   ```
+
 Original sources
 ================