nix.dev icon indicating copy to clipboard operation
nix.dev copied to clipboard

Terminology: run time or run-time or runtime

Open fricklerhandwerk opened this issue 3 years ago • 6 comments

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:

  • evaluate
  • build
  • run

fricklerhandwerk avatar Dec 09 '22 11:12 fricklerhandwerk

The Nix thesis uses "runtime".

Page 12 of The Nix thesis with 'runtime' highlighted

yukiisbored avatar Dec 09 '22 11:12 yukiisbored

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

yukiisbored avatar Dec 09 '22 11:12 yukiisbored

Nixpkgs manual is inconsistent:

68 results for "runtime" image

16 results for "run-time" image

6 results for "run time" image

yukiisbored avatar Dec 09 '22 11:12 yukiisbored

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

yukiisbored avatar Dec 09 '22 11:12 yukiisbored

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

fricklerhandwerk avatar Dec 09 '22 11:12 fricklerhandwerk

superfluous space in the title

evils avatar Mar 02 '23 09:03 evils