Thank you for your interest in contributing to CredFinder! This document provides guidelines and instructions for contributing.
By participating in this project, you agree to maintain a respectful and inclusive environment for everyone.
If you find a bug, please create an issue with the following information:
- A clear, descriptive title
- Steps to reproduce the issue
- Expected behavior vs. actual behavior
- Your environment details (OS, shell version, etc.)
- Any relevant logs or screenshots
We welcome suggestions for enhancements! Please create an issue that includes:
- A clear, descriptive title
- A detailed description of the proposed enhancement
- Any potential implementation details or ideas
- Why this enhancement would be useful to most users
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Write your code and add tests if applicable
- Make sure your code lints and follows the project style
- Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Use the present tense ("Add feature" not "Added feature")
- Use the imperative mood ("Move cursor to..." not "Moves cursor to...")
- Limit the first line to 72 characters or less
- Reference issues and pull requests liberally after the first line
- Use 4 spaces for indentation (not tabs)
- Add comments for complex logic
- Use uppercase for constants and lowercase for variables
- Include error handling for commands that might fail
- Follow defensive programming practices for user input
- Be mindful of performance when modifying the scanning functionality
- Test with large repositories to ensure changes don't degrade performance
- Ensure any changes maintain or improve the security of the tool
- Be careful with external dependencies and execution of user-provided input
Thank you for contributing to CredFinder!