--- name: voice description: How Solnix writes. Use when writing docs, replies, commit messages or site text for Solnix. --- # Voice - Plain and technical. State what a thing is and how it works. Short sentences. - Meet the reader where they are: most arrive from Linux, a BSD, macOS or Windows. Lead with a translation from what they know, then the illumos mechanism. - Use the real names: SMF, FMRI, ZFS boot environment, zone, DTrace, `ipadm`. Link the first mention to its man page (`https://solnix.io/docs/man/.
`). - Brand: "Solnix" capitalised in prose; `solnix` lowercase only in code (domains, commands, store paths, identifiers). "illumos" and "nixpkgs" lowercase; "Nix" and "NixOS" capitalised. - No marketing words: not "robust", "seamless", "powerful", "leverage", "simply". - Cite, don't assert: point at the live source for counts, status and versions. Source: the site style rule, enforced by `site/qa/check-content.sh` in [solnix-site](https://codeberg.org/solnix/solnix-site).