Nothing Special   »   [go: up one dir, main page]

Skip to content

Latest commit

 

History

History
25 lines (19 loc) · 1.87 KB

CONTRIBUTING.md

File metadata and controls

25 lines (19 loc) · 1.87 KB

For significant changes, please first discuss the change you wish to make with the owners of this repository via an issue. This would allow for discussing possible solutions and improve searchability.

Also please kindly follow the following guidelines:

  • respect the naming conventions in the code and code style in general. In particular: indentation, keywords in lower case, etc ...
  • respect the name-spacing. e.g. call new objects like ZxxTEXT2TAB_xx (where first xx stays for conventional object prefixes - ZCL_, ZTT_ ...)
  • please create pull requests on top of the latest code, rebase your changes, try to avoid merging please
  • please add meaningful descriptions to commit
  • please maintain the documentation appropriately e.g. update the README.md with details of changes to the interface
  • please kindly restrain from changing the versions unless agreed with the owners of this repository
  • please keep pull requests small and focused on one issue. Don't mix formatting fixes with functional changes
  • keep functions/methods short and focused on one task (NASA style, < 60 lines of code is a good example)

Variable naming

  • method params should be prefixed with 'I', 'E', 'C', 'R' for importing, exporting, changing, returning respectively
  • local variables should be generally prefixed as 'LT' for tables, 'LS' for structures, 'LV' for values, e.g. lt_lines
  • iterators (field-symbols) however should not have prefixes e.g. <line>
  • meaningful names are good even if they are long. Iterators can exceptionally have short names

Other considerations

  • Functional programming approach is welcomed. In particular use static side-effect-less methods where appropriate. They are easier to test and less bug-prone.
  • Avoid undefined state, use asserts/exceptions, code should self protect itself
  • Code should be as self descriptive as possible - use meaningful variable and function/method names