# Issue & Contribution Guidelines
Thank you for your interest in contributing to Claude Cookbooks! This guide helps you understand what types of contributions we welcome and how to make them effectively.
## Before You Open an Issue
1. **Search existing issues** - Your question or bug may already be reported 2. **Check the docs** - Many questions are answered in [Claude Documentation](https://docs.claude.com) 3. **Review CONTRIBUTING.md** - For development setup and contribution guidelines
## Issue Types
### Bug Reports
Use bug reports for: - Broken links or missing files - Code that doesn't execute properly - Incorrect or outdated information - Missing dependencies or setup issues
**Good bug reports include:** - Specific file/notebook affected - Steps to reproduce the issue - Expected vs actual behavior - Your environment (Python version, OS)
### Cookbook Proposals
We welcome proposals for new cookbooks that demonstrate Claude's capabilities. Before proposing:
**We're looking for:** - Notebooks that showcase Claude API/SDK capabilities directly - Practical, real-world use cases - Clear educational value with problem-focused learning - Self-contained examples that users can run immediately
**We generally don't accept:** - Translations of external frameworks or projects into the SDK - Notebooks that primarily promote external tools or services - Content that duplicates existing official documentation - Proposals without concrete implementation plans
**Strong proposals include:** 1. **Problem statement** - What problem does this solve for users? 2. **Claude capabilities** - Which API/SDK features does this demonstrate? 3. **Learning objectives** - What will users learn? 4. **Outline** - High-level structure of the proposed notebook 5. **Differentiation** - How is this different from existing cookbooks?
### Questions & Help
For usage questions: - **API/SDK questions**: Check [Claude Documentation](https://docs.claude.com) first - **General help**: Join our [Discord Community](https://anthropic.com/discord) - **Specific cookbook issues**: Open an issue referencing the notebook
### Community Projects & Resources
Want to share a project you've built with Claude? The best places to showcase your work are: - **Discord**: Share in the **#share-your-project** channel on our [Discord](https://anthropic.com/discord) - **Reddit**: Post to the [r/ClaudeAI](https://reddit.com/r/ClaudeAI) community
These communities are great for getting feedback, connecting with other developers, and showcasing your work.
## Response Expectations
- **Bug reports**: We aim to triage within a few days - **Proposals**: We review periodically; complex proposals may take longer - **Questions**: Consider Discord for faster community responses - **PRs**: See our PR review process in CONTRIBUTING.md
## What Happens After You Submit
1. **Triage** - We'll label and categorize your issue 2. **Discussion** - We may ask clarifying questions 3. **Decision** - For proposals, we'll indicate if it fits our roadmap 4. **Action** - Accepted items get scheduled for work or PR review
## Contributing Code
Ready to contribute? See [CONTRIBUTING.md](../CONTRIBUTING.md) for: - Development setup instructions - Code quality standards - PR guidelines - Testing requirements
## Getting Help
- **Documentation**: [docs.claude.com](https://docs.claude.com) - **Discord**: [anthropic.com/discord](https://anthropic.com/discord) - **API Status**: [status.anthropic.com](https://status.anthropic.com)
## Code of Conduct
We expect all contributors to be respectful and constructive. Issues that are spam, off-topic, or violate community standards may be closed without response.
---
Thank you for helping improve Claude Cookbooks!