# Contributing to Intelligent Apps & Agents Workshop

Thank you for your interest in contributing to the Intelligent Apps & Agents Workshop! We welcome contributions from the community to help improve this educational resource.

## Contributor License Agreement (CLA)

All contributions must be made subject to Microsoft's [Contributor License Agreement (CLA)](https://cla.opensource.microsoft.com). When you submit a pull request, a CLA bot will automatically guide you through the process if you haven't already signed the CLA. You only need to do this once across all Microsoft open-source repositories.

## How to Contribute

### Reporting Issues

- Check existing issues to avoid duplicates
- Use the issue templates when available
- Provide clear, detailed descriptions
- Include steps to reproduce for bugs

### Submitting Changes

1. **Fork** the repository
2. **Create** a feature branch from `main`
3. **Make** your changes following our guidelines
4. **Test** your changes thoroughly
5. **Submit** a pull request with a clear description

### Content Guidelines

When contributing to workshop content:

- **Labs**: Ensure step-by-step instructions are clear and accurate, and follow the Style Guide
- **Documentation**: Use clear, accessible language
- **Code Samples**: Follow best practices and include comments
- **Screenshots**: Use consistent formatting and ensure they're up-to-date

### File Organization

- Place lab content in appropriate module folders
- Follow existing naming conventions
- Update table of contents when adding new content
- Ensure all links work correctly

## Development Setup

1. Clone the repository
2. Review the README.md for project overview
3. Test any workshop labs you modify
4. Verify all documentation renders correctly

## Pull Request Process

1. Ensure your PR description clearly describes the changes
2. Reference any related issues
3. Include testing information if applicable
4. Be responsive to review feedback
5. Ensure CI checks pass

## Questions?

If you have questions about contributing, please:

- Review the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
- Open an issue for project-specific questions

Thank you for helping make this workshop better for everyone!