- Create CONTRIBUTING.md with comprehensive guidelines for community contributions - Develop ROADMAP.md outlining near-term, mid-term, and long-term project goals - Provide clear instructions for code style, testing, and community engagement - Define project vision and future enhancement strategies
1.5 KiB
1.5 KiB
Contributing to Home Assistant MCP
We welcome contributions from the community! Your help and feedback are essential to improving the MCP Server. Please review the following guidelines before contributing.
How to Contribute
- Fork the Repository: Create your personal fork of the project on GitHub.
- Create a Feature Branch: Use clear branch names, e.g.,
feature/your-featureorbugfix/short-description. - Make Changes: Develop your feature or fix bugs. Ensure your code follows the project's coding conventions.
- Write Tests: Include tests for new features or bug fixes. We aim for high code coverage.
- Submit a Pull Request (PR): Once your changes are complete, submit a PR. Our team will review your request and provide feedback.
- Address Feedback: Make any necessary revisions based on code review feedback.
Code Style Guidelines
- Follow the project's established coding style.
- Use Bun tooling for linting and formatting:
bun run lintfor lintingbun run formatfor formatting
Documentation
- Update relevant documentation alongside your code changes.
- Ensure that tests pass and coverage remains high.
Reporting Issues
- Use the GitHub Issues page to report bugs, request new features, or ask questions.
- Provide clear descriptions, replication steps, and any error logs.
Community
- Join our real-time discussions on our chat platforms (Discord, Slack, etc.).
- Engage with other contributors to exchange ideas and solutions.
Thank you for helping improve the Home Assistant MCP project!