Skip to content

Latest commit

 

History

History
86 lines (65 loc) · 2.26 KB

File metadata and controls

86 lines (65 loc) · 2.26 KB

Contributing to PlantPal

We love your input! We want to make contributing to PlantPal as easy and transparent as possible, whether it's:

  • Reporting a bug
  • Discussing the current state of the code
  • Submitting a fix
  • Proposing new features
  • Becoming a maintainer

Development Process

We use GitHub to host code, to track issues and feature requests, as well as accept pull requests.

  1. Fork the repo and create your branch from main
  2. If you've added code that should be tested, add tests
  3. If you've changed APIs, update the documentation
  4. Ensure the test suite passes
  5. Make sure your code lints
  6. Issue that pull request!

Pull Request Process

  1. Update the README.md with details of changes to the interface
  2. Update the requirements.txt with any new dependencies
  3. Increase the version numbers in any example files and the README.md to the new version
  4. The PR will be merged once you have the sign-off of two other developers

Contribution Areas

Frontend Development

  • React components
  • Mobile app features
  • UI/UX improvements
  • Accessibility enhancements

Backend Development

  • API endpoints
  • Database optimizations
  • Caching improvements
  • Authentication features

Machine Learning

  • Model improvements
  • Dataset contributions
  • Training pipeline optimizations
  • Mobile model optimization

Documentation

  • Technical documentation
  • User guides
  • API documentation
  • Code comments

Reward System

Contributors can earn ROXN tokens for their contributions. The reward amount depends on:

  • Task complexity
  • Impact of contribution
  • Code quality
  • Documentation quality

Code Style

Python

  • Follow PEP 8 guidelines
  • Use type hints
  • Write docstrings for functions and classes
  • Maximum line length of 88 characters

JavaScript/TypeScript

  • Use ESLint configuration
  • Follow Prettier formatting
  • Write JSDoc comments for functions
  • Use TypeScript where possible

Git Commit Messages

  • 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

License

By contributing, you agree that your contributions will be licensed under its MIT License.