add rules for time format, casing, sql & Codegen
This commit is contained in:
parent
9de9af8e99
commit
57886016ab
@ -58,6 +58,8 @@ Do **not** change the formatting of license texts (e.g.
|
||||
- We use the string `TODO` to mark bits of code that need improvement.
|
||||
- We use the string `DEBUG` to mark bits of code that are only for debugging
|
||||
(remove before next commit).
|
||||
- We use `YYYY-MM-DD hh:mm:ss` (in `UTC`) as date & time format.
|
||||
- We use `camelCase` where possible.
|
||||
- We add (if possible) the following header to files that contain a reasonable
|
||||
amount of self-written code or are essential to the project:
|
||||
|
||||
@ -82,6 +84,16 @@ Do **not** change the formatting of license texts (e.g.
|
||||
|
||||
### File specific rules
|
||||
|
||||
#### SQL (.sql)
|
||||
|
||||
- We avoid using spaces and keywords (escape with `` ` `` if necessary).
|
||||
- We write keywords in queries as `ALL CAPS`.
|
||||
- We name databases in `ALL CAPS`
|
||||
- We name tables in `PascalCase`.
|
||||
- We name columns in `camelCase`.
|
||||
- We name foreign keys in this scheme: `FK_SourceTable_sourceColumn`.
|
||||
- We prefix booleans with `IS_`.
|
||||
|
||||
#### Markdown (.md)
|
||||
|
||||
- We add a single `h1` element per document (as a title of the document).
|
||||
@ -99,7 +111,7 @@ Do **not** change the formatting of license texts (e.g.
|
||||
---
|
||||
```
|
||||
|
||||
#### YAML
|
||||
#### YAML (.yaml)
|
||||
|
||||
We indent using spaces (1 space wide).
|
||||
|
||||
@ -119,6 +131,17 @@ We use the `.yaml` file ending.
|
||||
|
||||
- We use `.graphqls` for defining our graph scheme.
|
||||
|
||||
## Generating code/using tools
|
||||
|
||||
This paragraph does not refer to code generation using neural networks/Ai/LLMs,
|
||||
which is currently disallowed, but instead to _classical Codegen_ (e.g.
|
||||
[gqlgen](https://github.com/99designs/gqlgen)).
|
||||
|
||||
- We document the general steps & commands we use to generate code in
|
||||
[CMD_HISTORY.md](./CMD_HISTORY.md) and commit the result without much
|
||||
modifications. Instead, we commit the necessary changes in an additional
|
||||
commit.
|
||||
|
||||
## Commit messages
|
||||
|
||||
- We write in all lowercase except for special names, e.g. `update Makefile`
|
||||
|
Loading…
Reference in New Issue
Block a user