Skip to content

Conversation

andrewleech
Copy link

Summary

This PR improves the README.md documentation by:

  • Adding a comprehensive step-by-step guide for updating MCU series to new vendor versions
  • Documenting the vendor/work branch workflow with concrete examples
  • Updating the title and introduction to include all currently supported MCU series (G0, H5, L1, N6, WL were previously missing)

The new "Updating to a new vendor version" section covers:

  • Cloning/fetching upstream STM32Cube repositories
  • Using fetch_from_upstream.sh to import vendor code
  • Proper commit message format and tagging conventions
  • Creating work branches and rebasing MicroPython patches
  • Pushing and creating pull requests

This makes the workflow more accessible to contributors and reduces the risk of manual errors when updating vendor libraries.

Testing

Documentation-only change. The instructions have been validated through successful execution of the WB v1.23.0 update (see PR #27).

Trade-offs and Alternatives

N/A - pure documentation improvement with no code changes.

@andrewleech andrewleech force-pushed the readme-workflow-improvements branch 5 times, most recently from 33cd176 to 29033f6 Compare October 14, 2025 01:36
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
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