haskell / haskell/cabal

s/nix style/v2-build/ in the documentation

Open
#6,105 18 comments 7 reactions 0 assignees View on GitHub
attention: pr-welcome documentation type: discussion
Dominant language
Haskell
Stars
1.7k
Forks
750
Avg merge
4d 3h
Merged PRs (30d)
28

Description

I conjecture that mentioning Nix only adds confusion. Almost all people I know use `v2-build` (well actually they use `new-build`, but maybe `v2-build` is a bit better).

E.g.

- One of the primary innovations of Nix-style local builds is the distinction between local packages, which users edit and recompile and must be built per-project, versus external packages, which can be cached across projects.
+ One of the primary innovations of `v2-build` local builds is the distinction between local packages, which users edit and recompile and must be built per-project, versus external packages, which can be cached across projects.

Contributor guide

Open the contributing guide

Research direction

Search the documentation for occurrences of “Nix-style” and inspect the surrounding terminology, including the example in the issue. Check the discussion before changing wording, since the proposed replacement is uncertain and the thread has been inactive for months; done means the agreed terminology is applied consistently.

Written by the indexing model from the issue text.

Assessment

Tech stack
haskell
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.