4 The Compiler Company Styleguide)}}}
6 As an organization we maintain a styleguide
[fn:1] which lists all of
7 the style guidelines we use for our code. If you are contributing to
8 one of our projects, you should review and understand the relevant
11 You should also review the
[[file:ulang.org][ulang]] document, which may shine some light
12 on code comments and developer docs.
14 [fn:1] https:
//google.github.io/styleguide/ 24 - start every source-file with a header comment
25 - use outline headings to organize your program
26 - use ulang-comments as needed for referencing bugs, notes, etc.
27 - inline documentation should be declarative. your code explains your
32 - prefer symbol docs to comments
33 - use stdin/stdout/stderr correctly - see
[[https://zenodo.org/records/3414191][CDR-11]] 34 - prefer
=core= libraries over vendored
38 - don't make
=mod.rs= files
39 - use the
=foo.rs=,
=foo/*= pattern instead