Coding and design guidelines

Coding and design guidelines

• Server
  • 0. Folder structure
  • 1. Naming convention
  • 2. Single responsibility principle
  • 3. Small methods
  • 4. Duplication
  • 5. Variables and methods declaration
  • 6. Structure your code correctly
  • 7. Database
  • 8. Comments
  • 9. Utility
  • 10. Auto configuration
  • 11. Keep your @RestController’s clean and focused
  • 12. Dependency injection
  • 13. Keep it simple and stupid
  • 14. File handling
  • 15. General best practices
  • 16. Avoid service dependencies
  • 17. Proper annotation of SQL query parameters
  • 18. SQL statement formatting
  • 19. Avoid the usage of Sub-queries
  • 20. REST endpoint best practices for authorization
  • 21. Assert using the most specific overload method
  • 22. General Testing Tips
  • 23. Avoid using @MockBean
• Client
  • 0. General
  • 1. Names
  • 2. Components
  • 3. Types
  • 4. null and undefined
  • 5. General Assumptions
  • 6. Comments
  • 7. Strings
  • 8. Buttons and Links
  • 9. Icons with Text
  • 10. Style
  • 11. Preventing Memory Leaks
    • What are memory leaks?
    • What are common reasons for memory leaks?
    • What are ways to identify memory leaks?
  • 12. Defining Routes and Breadcrumbs
  • 13. Strict Template Check
    • Use ArtemisTranslatePipe instead of TranslatePipe
    • Use ArtemisTimeAgoPipe instead of TimeAgoPipe
  • 14. Chart Instantiation
• Client Tests
• Database Relationships
  • 1. Retrieving and Building Objects
  • 2. Relationships
  • 2. Cascade Types
  • Best Practices
  • Solutions for known issues
• Development Process (How to Merge Changes)
  • Naming Conventions for GitHub Pull Requests
  • Steps to Create and Merge a Pull Request
    • 0. Precondition -> only Developer
    • 1. Start Implementation -> only Developer
    • 2. Implementation is “done” -> only Developer
    • 3. Review
    • 4. Respond to review
    • 5. Merge
• Inclusive, Diversity-Sensitive, and Appreciative Language
  • Motivation
  • English language
  • German language
  • Sources and further material