NixOS / nix.dev

Official documentation for getting things done with Nix.
https://nix.dev
Creative Commons Attribution Share Alike 4.0 International
2.49k stars 249 forks source link

Terminology: run time or run-time or runtime #412

Open fricklerhandwerk opened 1 year ago

fricklerhandwerk commented 1 year ago

Documentation needs consistent terminology. Define the term to use across all documents.

Wiktionary: run-time

In Nix we have at least three phases which we usually call \<phase>(' '|'-'|'')time:

yukiisbored commented 1 year ago

The Nix thesis uses "runtime".

Page 12 of The Nix thesis with 'runtime' highlighted

yukiisbored commented 1 year ago

It seems the Nix manual also use "runtime": https://nixos.org/manual/nix/stable/glossary.html?highlight=runtime#glossary

yukiisbored commented 1 year ago

Nixpkgs manual is inconsistent:

68 results for "runtime" image

16 results for "run-time" image

6 results for "run time" image

yukiisbored commented 1 year ago

While "runtime" is the most popular one, I don't think it makes sense to use "evaluatetime" nor "buildtime".

I couldn't find references for "evaluatetime", "evaluate time", "evaluate-time" in the Nix manual nor nixpkgs manual.

However, "build time" and "build-time" are both used in Nixpkgs manual, along with a glossary entry in Nix manual: https://nixos.org/manual/nix/stable/glossary.html?highlight=build-time#glossary

fricklerhandwerk commented 1 year ago

People usually write "eval-time" or "evaluation time", which is next level of inconsistent.

evils commented 1 year ago

superfluous space in the title