nix.dev

nix.dev copied to clipboard

A user guide for nix repl could be very helpful.

Regardless of whether the guide is added prior to or after stabilization, this is a tracking issue.

Blocked by: #499

---

Co-authored-by: @mightyiam

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/usability-study-session-4/21422/1

This may be more suitable for nix.dev, since the Nix manual is supposed to be reference only. @NixOS/documentation-team should we move this issue there?

@fricklerhandwerk Sounds good to me

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/2023-03-21-documentation-team-meeting-notes-34/26619/1

Discussed in the Nix documentation team meeting:

• @henrik-ch: Also related:
  • https://github.com/NixOS/nix/issues/7646
  • https://github.com/NixOS/nix/pull/7661
  • https://github.com/NixOS/nix/issues/7956
• @gabriella: Where to slot nix repl into nix.dev?
  • @pennae: Basics sounds good
  • @gabriella: After Nix Language Basics
• Starting nix repl tour tutorial in https://pad.lassul.us/scSWEzl7RqCAx0D3TdnO3g?edit
  • First brainstorm ideas for what should be included
  • Start writing sections
• Questions that came up:
  • Should we show nix repl '<nixpkgs>'? It's been deprecated since 2.10
    • Let's make it a prerequisite to have a recent Nix version
  • Should we recommend using :doc when there's the manual?
    • @pennae: It's easier to access :doc

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/2023-03-23-documentation-team-meeting-notes-35/26651/1