1
0
requests_util/CONVENTIONS.md
2025-03-14 00:13:58 +01:00

915 B

When contributing code to this project, you MUST follow these principles:

  • Code should be easy to read and understand.
  • Keep the code as simple as possible. Avoid unnecessary complexity.
  • Use meaningful names for variables, functions, etc. Names should reveal intent.
  • Functions should be small and do one thing well. They should not exceed a few lines.
  • Function names should describe the action being performed.
  • Only use comments when necessary, as they can become outdated. Instead, strive to make the code self-explanatory.
  • When comments are used, they should add useful information that is not readily apparent from the code itself.
  • Properly handle errors and exceptions to ensure the software's robustness.
  • Use exceptions rather than error codes for handling errors.
  • Consider security implications of the code. Implement security best practices to protect against vulnerabilities and attacks.