mirror of
https://github.com/getAsterisk/claudia.git
synced 2025-07-07 18:15:00 +00:00
parent
f1377833b3
commit
552ae03362
1 changed files with 67 additions and 0 deletions
67
CONTRIBUTING.md
Normal file
67
CONTRIBUTING.md
Normal file
|
@ -0,0 +1,67 @@
|
|||
# Welcome Contributors
|
||||
|
||||
We welcome contributions to enhance Claudia's capabilities and improve its performance. To report bugs, create a [GitHub issue](https://github.com/getAsterisk/claudia/issues).
|
||||
|
||||
> Before contributing, read through the existing issues and pull requests to see if someone else is already working on something similar. That way you can avoid duplicating efforts.
|
||||
|
||||
To contribute, please follow these steps:
|
||||
|
||||
1. Fork the Claudia repository on GitHub.
|
||||
2. Create a new branch for your feature or bug fix.
|
||||
3. Make your changes and ensure that the code passes all tests.
|
||||
4. Submit a pull request describing your changes and their benefits.
|
||||
|
||||
## Pull Request Guidelines
|
||||
|
||||
When submitting a pull request, please follow these guidelines:
|
||||
|
||||
1. **Title**: Please include following prefixes:
|
||||
- `Feature:` for new features
|
||||
- `Fix:` for bug fixes
|
||||
- `Docs:` for documentation changes
|
||||
- `Refactor:` for code refactoring
|
||||
- `Improve:` for performance improvements
|
||||
- `Other:` for other changes
|
||||
|
||||
For example:
|
||||
- `Feature: added custom agent timeout configuration`
|
||||
- `Fix: resolved session list scrolling issue`
|
||||
|
||||
2. **Description**: Provide a clear and detailed description of your changes in the pull request. Explain the problem you are solving, the approach you took, and any potential side effects or limitations of your changes.
|
||||
|
||||
3. **Documentation**: Update the relevant documentation to reflect your changes. This includes the README file, code comments, and any other relevant documentation.
|
||||
|
||||
4. **Dependencies**: If your changes require new dependencies, ensure that they are properly documented and added to the `package.json` or `Cargo.toml` files.
|
||||
|
||||
5. If the pull request does not meet the above guidelines, it may be closed without merging.
|
||||
|
||||
**Note**: Please ensure that you have the latest version of the code before creating a pull request. If you have an existing fork, just sync your fork with the latest version of the Claudia repository.
|
||||
|
||||
## Coding Standards
|
||||
|
||||
### Frontend (React/TypeScript)
|
||||
- Use TypeScript for all new code
|
||||
- Follow functional components with hooks
|
||||
- Use Tailwind CSS for styling
|
||||
- Add JSDoc comments for exported functions and components
|
||||
|
||||
### Backend (Rust)
|
||||
- Follow Rust standard conventions
|
||||
- Use `cargo fmt` for formatting
|
||||
- Use `cargo clippy` for linting
|
||||
- Handle all `Result` types explicitly
|
||||
- Add comprehensive documentation with `///` comments
|
||||
|
||||
### Security Requirements
|
||||
- Validate all inputs from the frontend
|
||||
- Use prepared statements for database operations
|
||||
- Never log sensitive data (tokens, passwords, etc.)
|
||||
- Use secure defaults for all configurations
|
||||
|
||||
## Testing
|
||||
- Add tests for new functionality
|
||||
- Ensure all existing tests pass
|
||||
- Run `cargo test` for Rust code
|
||||
- Test the application manually before submitting
|
||||
|
||||
Please adhere to the coding conventions, maintain clear documentation, and provide thorough testing for your contributions.
|
Loading…
Add table
Add a link
Reference in a new issue