Show TOC

Development Conventions and GuidelinesLocate this document in the navigation structure

To keep the SAPUI5 code readable and maintainable, development conventions and guidelines are introduced. We strongly recommend that you follow these guidelines even if you find them violated somewhere. For files that are consistently not following these rules and for which adhering to the rules would make the code worse, follow the local style.

Note

This list is not complete.

General Guidelines

The following list gives some general guidelines to be adhered to when developing content for SAPUI5:

  • Always consider the developers who use your control or code! Do not surprise them, but give them what they expect. And make it simple.

  • Use tabs, not spaces, for indentation; adhere to local standards in the file.

  • Use Unix line endings (LF-only).

    In Eclipse, this is configured in Start of the navigation path Preferences Next navigation step General Next navigation step Workspace Next navigation step New Text File Line Delimiter End of the navigation path.

  • Text files must be UTF-8 encoded (HANA); only *.properties and *.hdbtextbundle files must be ISO8859-1 encoded as defined in the corresponding standard.

    This is the status quo. As this causes issues, it may be subject to change. In Eclipse, this is configured in Start of the navigation path Preferences Next navigation step General Next navigation step Workspace Next navigation step Text File Encoding End of the navigation path.

  • An 80-character line length guideline does not exist.

  • Use comments; do not rephrase the code, but tell the reader what is not in the code. Describe why your code does what it does. Prefer line comments.