Skip to content

Latest commit

 

History

History
35 lines (28 loc) · 2.16 KB

CONTRIBUTING.md

File metadata and controls

35 lines (28 loc) · 2.16 KB

🧩 Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository.
  2. Create a new branch ( using this convention).
  3. Make your changes and commit them with descriptive messages.
  4. Push your changes to your fork.
  5. Create a pull request to the main repository.

Read documentation to know more about the actual implementation of WebWeaver

👨‍💻 Development guidelines

  • Modularity: functions should be small and focused on a single responsibility
  • Separation of Concerns: maintain clear separation between business logic and utility functions
  • Error Handling: handle errors gracefully. All errors should be logged using the utilities provided
  • Documentation: add comments to explain complex logic, particularly when working with external libraries

🎨 Code style

  • Naming: use camelCase for function and variables names
  • Clarity and Consistency: keep variable and function names descriptive, avoid unnecessary abbreviations
  • Types: specify varibles types in declaration where it doesn't look redoundaunt
  • Error Handling: check all errors explicitly, avoid ignoring errors
  • Formatting: ensure your code is properly formatted using gofmt
  • Comments: add a one-line comment before every function to explain what will do
  • Imports: organize imports into three sections:
    1. Standard library packages
    2. Internal project packages
    3. External libraries

Ensure all your tests pass before submitting a PR, update documentation if your changes affect the program's behaviour

These guidelines are designed to keep the codebase readable, maintainable, and consistent, even when multiple developers contribute. Following a common style helps reduce errors and makes the code easier to understand for others in the team. If you'd like to add more specific guidelines or have questions, feel free to ask!

Thank you for contributing to WebWeaver! Your efforts are deeply appreciated. If you have any questions, feel free to reach out in the project discussions or open an issue.