mirror of
https://github.com/luxfhe/ml-sdk.git
synced 2026-10-30 18:13:04 +00:00
zeekay
397da37894
Files edited: 150 Brand-hit files before: 163 Brand-hit files after: 28 Substitutions: - Zama Concrete ML -> TorusML - Zama Concrete / Concrete-> Torus - Zama fhEVM / fhEVM -> TorusEVM - Zama TFHE-rs / tfhe-rs -> Lux-FHE (github.com/luxfi/fhe) - Zama (attribution) -> Lux Industries - zama-ai/* (GitHub) -> luxfhe/* - @zama-fhe/* (npm) -> @luxfhe/* - docs.zama.ai -> docs.lux.network - Fhenix / CoFHE -> dropped or rewritten to Lux FHE / TorusEVM coprocessor Text-only changes. No runtime code semantics altered.
2.1 KiB
2.1 KiB
Conventions
The only place we can say we/our is in a blog post written by a named author. Anything signed Lux Industries should not use we/our. So, no "We" or "Our" in our documentation.
Let's use following conventions for the docs. If a new convention needs to be decided, let's agree and then add it here.
Style
- The documentation can address the user directly e.g., "you can find out more at ..", but this style should not be abused, do not be too colloquial !
- The documentation should not refer to its writers or to TorusML developers/Lux Industries as "we", and thus it should not use "our" either.
Terms
- Use hyphenated versions for portmanteaus, unless the term is in the dictionary, example:
- bit-width [not: bitwidth, bit width]
- input-set, data-set
- database, codebase is fine (not data-base, code-base)
- de-quantize/re-quantize
- "an FHE program" not "a FHE program"
- Machine Learning or machine learning, depends on the context
- google is a verb ("you can google" but not "you can Google") : but try to avoid this
- Programs:
- Jupyter
- TorusML (no TorusML)
- pytest except when title where it is capitalized
- Python
- torch (for the code) and PyTorch (for the product)
- scikit, sklearn and scikit-learn are acceptable
- Hummingbird
- Docker (for the product) or docker (for the binary)
- Poetry (for the product) or poetry (for the binary)
- Make (for the product) or make (for the command line)
- PoissonRegression or Poisson Regression (depends on the context, we'll fix it in Lux Industries)
- macOS
- bare OS
Variables
- Variables names should use ticks:
variable_nameorvariable_name=10.5 - If a number is just stated, not in a code block, then it's just 10.5 not
10.5.
Titles
- Main titles (with a single #) are
Capitalized at Each Letter - Sub titles (with two or more #s) are
Capitalized only for first letter
Links
- Use links from doc root (i.e., ../../user/explanation/quantization.md) instead of using the smallest number of ../ that works; it makes files easier to move