# User Feedback Guide
Thank you for using the Simplenote MCP Server! Your feedback helps us improve the project and make it better for everyone.
## š How to Provide Feedback
### š Report Bugs
If you encounter a bug or unexpected behavior:
1. **Check Existing Issues**: Search [GitHub Issues](https://github.com/docdyhr/simplenote-mcp-server/issues) to see if it's already reported
2. **Use Bug Report Template**: Click "New Issue" ā "Bug Report"
3. **Provide Details**: Include:
- Clear description of the problem
- Steps to reproduce
- Expected vs actual behavior
- Version, OS, and deployment method
- Relevant logs (redact sensitive info)
[**ā Report a Bug**](https://github.com/docdyhr/simplenote-mcp-server/issues/new?template=bug_report.yml)
---
### ā” Report Performance Issues
If you experience slow performance:
1. **Use Performance Issue Template**: Click "New Issue" ā "Performance Issue"
2. **Include Metrics**: Provide specific numbers (startup time, memory usage, etc.)
3. **Share System Info**: OS, CPU, RAM, Python version
4. **Note Count**: How many notes do you have?
[**ā Report Performance Issue**](https://github.com/docdyhr/simplenote-mcp-server/issues/new?template=performance_issue.yml)
---
### āØ Request Features
Have an idea for a new feature?
1. **Search Discussions**: Check if someone already suggested it
2. **Use Feature Request Template**: Click "New Issue" ā "Feature Request"
3. **Explain Your Use Case**: Help us understand why it's valuable
4. **Provide Examples**: Show how it would work
[**ā Request a Feature**](https://github.com/docdyhr/simplenote-mcp-server/issues/new?template=feature_request.yml)
---
### š¬ Join Discussions
For general questions, ideas, or conversations:
1. **GitHub Discussions**: Ask questions, share use cases, connect with community
2. **Topics**:
- General Q&A
- Ideas and brainstorming
- Show & Tell (share what you've built!)
[**ā Start a Discussion**](https://github.com/docdyhr/simplenote-mcp-server/discussions)
---
## šÆ What We're Looking For
### High Priority Feedback
We especially want to hear about:
1. **v1.9.0 Performance**
- Startup time improvements
- Claude Desktop integration success
- Any remaining timeout issues
2. **Large Note Collections**
- How does it perform with 1000+ notes?
- Memory usage and search speed
- Cache synchronization behavior
3. **Real-World Use Cases**
- How are you using the server?
- What workflows does it enable?
- What features would enhance your usage?
4. **Documentation Gaps**
- What's confusing or unclear?
- What examples would help?
- What guides are missing?
---
## š Feedback Metrics
Help us track success by sharing:
- **Startup Time**: How long does the server take to start?
- **Note Count**: How many notes in your Simplenote account?
- **Use Case**: How do you use the server?
- **Satisfaction**: Rate your experience (1-5 stars)
---
## š Security Issues
**Do NOT report security vulnerabilities publicly!**
For security issues:
1. Use [GitHub Security Advisories](https://github.com/docdyhr/simplenote-mcp-server/security/advisories/new)
2. Provide detailed information privately
3. We'll respond within 48 hours
---
## š¤ Response Times
We aim for:
- **Bug Reports**: Response within 24 hours
- **Performance Issues**: Response within 24 hours
- **Feature Requests**: Response within 1 week
- **Discussions**: Response within 48 hours
- **Security Issues**: Response within 48 hours
---
## š Feedback Lifecycle
### What Happens After You Submit Feedback?
1. **Triage** (24-48 hours)
- Issue is labeled and categorized
- Assigned priority based on impact
- Maintainer may ask clarifying questions
2. **Investigation** (1-2 weeks)
- Root cause analysis for bugs
- Feasibility assessment for features
- Community discussion for ideas
3. **Implementation** (varies)
- Critical bugs: Immediate fix
- Features: Prioritized on roadmap
- Enhancements: Scheduled for releases
4. **Release** (varies)
- Patch releases for critical bugs
- Minor releases for features
- Major releases for breaking changes
5. **Follow-up**
- Confirmation that issue is resolved
- Request for testing/validation
- Credit in release notes
---
## š Recognition
We recognize valuable contributions:
- **Bug Reporters**: Listed in release notes
- **Feature Contributors**: Credit in CHANGELOG
- **Code Contributors**: Listed in GitHub contributors
- **Community Leaders**: Special recognition
---
## š Templates Quick Reference
| Type | Use When | Link |
|------|----------|------|
| š Bug Report | Something doesn't work | [Template](https://github.com/docdyhr/simplenote-mcp-server/issues/new?template=bug_report.yml) |
| ā” Performance Issue | Slow or resource-heavy | [Template](https://github.com/docdyhr/simplenote-mcp-server/issues/new?template=performance_issue.yml) |
| āØ Feature Request | New capability needed | [Template](https://github.com/docdyhr/simplenote-mcp-server/issues/new?template=feature_request.yml) |
| š¬ Discussion | Question or idea | [Discussions](https://github.com/docdyhr/simplenote-mcp-server/discussions) |
| š Security | Vulnerability found | [Security Advisory](https://github.com/docdyhr/simplenote-mcp-server/security/advisories/new) |
---
## š” Tips for Great Feedback
### For Bug Reports
ā
**DO**:
- Include reproduction steps
- Provide actual vs expected behavior
- Share logs and error messages
- Specify version and environment
- Redact sensitive information
ā **DON'T**:
- Report multiple bugs in one issue
- Include passwords or API keys
- Assume we know your setup
- Skip reproduction steps
### For Feature Requests
ā
**DO**:
- Explain the problem you're solving
- Describe your use case
- Provide concrete examples
- Consider implementation complexity
- Search for duplicates first
ā **DON'T**:
- Request duplicate features
- Expect immediate implementation
- Demand features without context
- Ignore existing discussions
---
## š Thank You!
Your feedback makes this project better for everyone. We appreciate:
- Taking time to report issues
- Providing detailed information
- Engaging with the community
- Contributing to discussions
- Sharing your use cases
**Every piece of feedback helps us improve!**
---
## š Need Help?
- **Documentation**: [README](../README.md) | [CHANGELOG](../CHANGELOG.md) | [TODO](../TODO.md)
- **Troubleshooting**: See [TESTING_CLAUDE_DESKTOP.md](../TESTING_CLAUDE_DESKTOP.md)
- **Contributing**: See [CONTRIBUTING.md](../CONTRIBUTING.md)
- **Discussions**: [GitHub Discussions](https://github.com/docdyhr/simplenote-mcp-server/discussions)
---
*Last Updated: 2025-10-28*
*Version: 1.9.0*
