🤝 Contributing to Cloud OSINT

Thank you for considering contributing to Cloud OSINT! Every contribution helps make this the definitive resource for cloud reconnaissance.

📋 How to Contribute

Suggesting a New Resource

1. Check for duplicates — Search the README to make sure the resource isn't already listed.
2. Open an Issue — Use the "Suggest a Resource" issue template to propose your addition.
3. Or submit a PR directly — If you're comfortable with Git, follow the PR process below.

Submitting a Pull Request

1. Fork this repository
2. Create a branch (git checkout -b add-new-resource)
3. Add your resource following the formatting guidelines below
4. Commit your changes (git commit -m "Add [Resource Name] to [Section]")
5. Push to your branch (git push origin add-new-resource)
6. Open a Pull Request using the PR template

✅ Formatting Guidelines

Every entry must follow this exact format:

- [Resource Name](https://url.com) - Brief description starting with uppercase, ending with period.

Rules:

• Use dashes (-) for list items, not asterisks or numbers.
• The description must start with an uppercase letter and end with a period.
• Descriptions should be concise (one sentence, ideally under 120 characters).
• Place the entry alphabetically within its category.
• URLs must be valid and accessible — no broken links.
• Do not include tracking parameters in URLs (remove ?utm_source=... etc.).

🎯 Quality Criteria

Resources added to this list should meet these criteria:

• Relevant — Directly related to cloud OSINT, reconnaissance, or cloud security assessment.
• Maintained — Actively maintained or still functional.
• Quality — Well-documented, with clear usage instructions.
• Legal — Must be a legitimate security tool or resource.

📂 Where to Add Your Resource

Type of Resource	Section
Search engines, web platforms	Web Cloud OSINT Resources
CLI tools, scripts, frameworks	Cloud OSINT Tools (appropriate subcategory)
Google search queries	Google Dorks (appropriate provider)
Shodan search queries	Shodan Dorks
Domain/subdomain tools	Domain & Subdomain Identification
Certificate tools	Certificate Transparency
Dork generators	Dork Generation Tools
Other/general	Additional Resources

🐛 Reporting Issues

Found a broken link, outdated tool, or formatting error? Open an issue using the "Report a Problem" template.

📜 Code of Conduct

This project follows a Code of Conduct. By participating, you agree to abide by its terms.

---

Thank you for helping make Cloud OSINT the best resource for the community! ☁️🔍