diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md new file mode 100644 index 0000000..12cc317 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -0,0 +1,60 @@ +--- +name: Bug Report +about: Report a bug with a blueprint +title: '' +labels: bug +assignees: '' +--- + +## Blueprint Name + +Which blueprint is affected? + +## Describe the Bug + +A clear description of what the bug is. + +## Environment + +- **Home Assistant version:** +- **Blueprint version/date downloaded:** + +## Steps to Reproduce + +1. +2. +3. + +## Expected Behavior + +What you expected to happen. + +## Actual Behavior + +What actually happened. + +## Blueprint Configuration + +
+Your blueprint inputs (remove sensitive data) + +```yaml +Paste configuration here +``` + +
+ +## Logs + +
+Relevant log entries + +``` +Paste logs here +``` + +
+ +## Additional Context + +Any other context about the problem. diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..801542e --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,8 @@ +blank_issues_enabled: true +contact_links: + - name: Home Assistant Community + url: https://community.home-assistant.io/ + about: Ask questions about Home Assistant + - name: Home Assistant Blueprint Documentation + url: https://www.home-assistant.io/docs/automation/using_blueprints/ + about: Learn about using blueprints diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md new file mode 100644 index 0000000..788cad3 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -0,0 +1,32 @@ +--- +name: Feature Request +about: Suggest a new blueprint or enhancement +title: '' +labels: enhancement +assignees: '' +--- + +## Request Type + +- [ ] New blueprint idea +- [ ] Enhancement to existing blueprint + +## Blueprint Name (if enhancement) + +Which blueprint should be enhanced? + +## Description + +A clear description of what you would like. + +## Use Case + +Describe the problem this would solve or the automation scenario. + +## Proposed Solution + +If you have ideas on how to implement this, describe them here. + +## Additional Context + +Any other context, examples, or screenshots. diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..54dab93 --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,24 @@ +## Description + +Brief description of the changes. + +## Type of Change + +- [ ] New blueprint +- [ ] Bug fix +- [ ] Enhancement to existing blueprint +- [ ] Documentation update + +## Blueprint(s) Affected + +List the blueprints added or modified. + +## Testing + +Describe how you tested these changes in Home Assistant. + +## Checklist + +- [ ] Blueprint tested in Home Assistant +- [ ] README.md updated (if adding new blueprint) +- [ ] Blueprint includes proper metadata (name, description, domain) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..b6286c4 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,45 @@ +# Contributing to Home Assistant Blueprints + +Thank you for your interest in contributing to this collection of Home Assistant blueprints! + +## Getting Started + +1. Fork the repository +2. Clone your fork locally +3. Create a new branch for your changes + +## Adding a New Blueprint + +1. Place your blueprint in the appropriate folder: + - `Common/` - General purpose blueprints + - `Zigbee/` - MQTT/Zigbee device blueprints +2. Follow the existing naming conventions +3. Include proper metadata in your blueprint (name, description, domain) +4. Update `README.md` to list your new blueprint + +## Blueprint Guidelines + +- Use clear, descriptive names for inputs +- Provide helpful descriptions and default values +- Include input validation where appropriate +- Test thoroughly before submitting + +## Submitting Changes + +1. Test your blueprint in Home Assistant +2. Update documentation if needed +3. Create a pull request with a clear description + +## Reporting Issues + +When reporting bugs, please include: + +- Home Assistant version +- Blueprint name +- Steps to reproduce +- Expected vs actual behavior +- Relevant log entries + +## Questions? + +Open an issue for any questions about contributing.