graze / standards
Graze coding standards
Installs: 334 114
Dependents: 49
Suggesters: 0
Security: 0
Stars: 6
Watchers: 14
Forks: 2
Open Issues: 1
Requires (Dev)
This package is auto-updated.
Last update: 2024-10-29 04:20:00 UTC
README
This documentation is also available in mkdocs.
This document describes the coding standards of Graze across its common languages to be adhered to and enforced by the Graze tech team, any violation of standards must be justified by the developer and exceptions are allowed for cases where it is unavoidable, such as in the case of third-party integrations.
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.
General
- Indent size MUST be 4 space characters and MUST NOT be the tab character.
- All files MUST end with a blank new line (the new line character).
- All files MUST use the Unix LF (linefeed) line ending.
- There MUST NOT be trailing whitespace.
Git
- Repo names SHOULD be all lowercase with hyphens (-) to separate words where appropriate.
- Internal-only libraries SHOULD be prefixed with "graze-".
- It is RECOMMENDED to follow the style guide mantained in agis-/git-style-guide.
Languages
Open Source
Environment
Visual
Development
You can test mkdocs by calling:
make docs-test
This will start a development server in docker on port 8000
.