# Contributing to Doing

Thank you for your interest in contributing to Doing! Whether you're fixing a bug, adding a feature, improving
documentation, or just asking questions — all contributions are welcome.

## Before You Start

Please read and agree to the following before contributing:

- **[Code of Conduct][coc]** — how we treat each other
- **[AI Use Policy][ai-policy]** — expectations around AI-assisted contributions

By submitting a contribution you acknowledge that you have read and agree to these policies and practices and that your
contributions will be licensed under the [MIT License][license].

## Getting Oriented

| Resource                    | What it covers                                           |
|-----------------------------|----------------------------------------------------------|
| [ADRs][adrs]                | Architecture decisions and their rationale               |
| [Process Guide][process]    | How we plan, review, and ship work                       |
| [Security Policy][security] | Reporting vulnerabilities responsibly                    |
| [Code Style Guide][style]   | Formatting rules and code organization conventions       |
| [Tasks][tasks]              | Running builds, tests, formatting, and linting with mise |
| [Testing][testing]          | How to write and organize tests                          |
| [Commits][commits]          | Conventional commit format and scoping rules             |

## Ways to Contribute

- **Report a bug** — [open an issue][new-issue] with steps to reproduce
- **Suggest a feature** — start a discussion or issue describing the problem you'd like solved
- **Fix a bug or implement a feature** — check the issue tracker for open items, or bring your own idea
- **Improve documentation** — typos, missing context, better examples — it all helps
- **Write or improve tests** — more coverage makes the project more reliable for everyone
- **Review pull requests** — thoughtful review is just as valuable as writing code
- **Report a security vulnerability** — follow the [Security Policy][security] instead of filing a public issue

## Questions?

If something is unclear, open a discussion or issue — we're happy to help.

[adrs]: https://github.com/aaronmallen/doing/blob/main/docs/design/README.md
[ai-policy]: https://github.com/aaronmallen/doing/blob/main/docs/policy/ai.md
[coc]: https://github.com/aaronmallen/doing/blob/main/docs/policy/code-of-conduct.md
[commits]: https://github.com/aaronmallen/doing/blob/main/docs/dev/commits.md
[license]: https://github.com/aaronmallen/doing/blob/main/LICENSE
[new-issue]: https://github.com/aaronmallen/doing/issues/new
[process]: https://github.com/aaronmallen/doing/blob/main/docs/process/README.md
[security]: https://github.com/aaronmallen/doing/blob/main/docs/policy/security.md
[style]: https://github.com/aaronmallen/doing/blob/main/docs/dev/code-style.md
[tasks]: https://github.com/aaronmallen/doing/blob/main/docs/dev/tasks.md
[testing]: https://github.com/aaronmallen/doing/blob/main/docs/dev/testing.md