Create pull requests for esphome-docs. Use when creating PRs, submitting changes, or preparing contributions.
When creating a pull request for esphome-docs, follow these steps:
Always base your branch on upstream (not origin/fork) to ensure you have the latest code:
git fetch upstream
git checkout -b <branch-name> upstream/current
Use upstream/current for documentation fixes, or upstream/next for new component docs.
Before creating a PR, read .github/PULL_REQUEST_TEMPLATE.md to understand required fields.
Use gh pr create with the full template filled in. Never skip or abbreviate sections.
Required fields:
fixes <link> syntax if applicablenext branch: New docs with matching esphome PRcurrent branch: Fixes/adjustments to existing docs/components/_index.md## Description:
<describe your changes here>
**Related issue (if applicable):** fixes https://github.com/esphome/esphome-docs/issues/XXX
**Pull request in [esphome](https://github.com/esphome/esphome) with YAML changes (if applicable):**
- N/A (or esphome/esphome#XXX)
## Checklist:
- [ ] I am merging into `next` because this is new documentation that has a matching pull-request in [esphome](https://github.com/esphome/esphome) as linked above.
or
- [x] I am merging into `current` because this is a fix, change and/or adjustment in the current documentation and is not for a new component or feature.
- [ ] Link added in `/components/_index.md` when creating new documents for new components or cookbook.
git push -u origin <branch-name>
gh pr create --repo esphome/esphome-docs --base current --title "[component] Brief description"
Use --base next if documenting a new feature with a matching esphome PR.