forked from AbleOS/ableos
47 lines
1.1 KiB
Markdown
47 lines
1.1 KiB
Markdown
|
# Style Guide
|
||
|
|
This style guide has two modes that a guideline may be.
|
||
|
|
|
||
|
|
`strict` means that prs will be rejected if they do not follow the guideline.
|
||
|
|
|
||
|
|
`loose` means that a pr would be accepted but should later be fixed.
|
||
|
|
|
||
|
|
|
||
|
|
## Magic Numbers | loose
|
||
|
|
The policy on magic numbers is make them const and have a comment above them. Typically linking to a source of information about the magic number.
|
||
|
|
|
||
|
|
This helps cut down on magic numbers while making acceptable names and atleast half assed documentation.
|
||
|
|
|
||
|
|
```rust
|
||
|
|
// The standard vga port is mapped at 0xB8000
|
||
|
|
$VGA_PTR := 0xB8000
|
||
|
|
```
|
||
|
|
|
||
|
|
## Tabs Vs Spaces | loose
|
||
|
|
I prefer for hblang code to use hard tabs.
|
||
|
|
|
||
|
|
The rational behind this is that a tab is `1 Indent` which some developers might want to be various different sizes when displayed
|
||
|
|
|
||
|
|
Soft tabs do not allow this user/editor specific as soft tabs always become spaces.
|
||
|
|
|
||
|
|
Bottom line is this is an accessibility feature.
|
||
|
|
|
||
|
|
There are some samples below.
|
||
|
|
```
|
||
|
|
\t means hard tab
|
||
|
|
\n means new line
|
||
|
|
\0x20 means space
|
||
|
|
```
|
||
|
|
|
||
|
|
### Allowed
|
||
|
|
```rust
|
||
|
|
if x == y {\n
|
||
|
|
\tlog(z)\n
|
||
|
|
}\n
|
||
|
|
```
|
||
|
|
|
||
|
|
### Not Allowed
|
||
|
|
```rust
|
||
|
|
if x == y {\n
|
||
|
|
\0x20\0x20\0x20\0x20log(z)\n
|
||
|
|
}\n
|
||
|
|
```
|