Contributing to Claude Guides

Thank you for helping improve Claude Guides. This document sets expectations for contributions to Berta-one/claude-guides.

Code of conduct

Be respectful and constructive. Harassment, hate speech, and spam are not tolerated in issues, discussions, or pull requests.

How to contribute

1. Small fixes (typos, broken links, clarifications): open a PR directly.
2. Larger changes (new guides, big refactors): open an issue first to align on scope.
3. Notebooks and scripts: keep examples runnable where possible; document API keys via environment variables, not hard-coded secrets.
4. Legal / policy pages: factual corrections welcome; substantive legal edits may need maintainer review.

Licence of contributions

This repository is released under the MIT License (see LICENSE). By submitting a pull request, you represent that:

• You have the right to submit the contribution, and
• You license your contribution under the same MIT terms as the project.

If your employer has rights in your contribution, ensure you are authorised to submit it under MIT.

Style

• Match the tone and structure of existing guides.
• Prefer clear, learner-oriented language.
• Run the site build locally if you change tools/build_site.py or assets: python tools/build_site.py.

Security

Do not open public issues for undisclosed security vulnerabilities. Use the contact in .well-known/security.txt on https://claudeguides.berta.one or email hello@rondaninipublishing.com with subject line “Security”.

Questions

Use GitHub Discussions or open an issue. See also LEGAL_HUB.md.