@toraritte:

Hey,

As I was afraid, by the time I was able to get to this task, I lost some of the context to my notes... I circled "use case"-oriented approach so just to clarify and recap what should be done:

What purpose are the cleaned up user studies intended to serve? Identify the major pain point and where people get derailed quickly? (... and also to give readers a glimpse of the "pathology" of frustrations with Nix in "real-time"?)
"to clean" up the notes means:

toraritte / nix-learning-journey-1.md

Created August 15, 2022 04:34

Nix Learning Journeys

1. Participant #1

Created: June 1, 2022 10:57 PM

1.1 Bio / persona

Learned computational linguistics at grad school with Haskell, but had no relevant experience with building software and dealing with dependencies. Never used Nix before, but has to get acquainted with it for a Haskell project that uses it. Only has a vague idea what it might be for, and how to use it on MacOS.

toraritte / notes_improve-nix-contribution-guidelines.md

Created August 11, 2022 12:59

Notes/tasks about making it easier to contribute to the Nix eco-system

Tasks/notes for self:

sync contribution guides namely:
- nixos.org - How to Contribute
- Nix manual - 9. Contributing
  - flesh out the 9.1 Hacking section because it doesn't even mention that Nix is written in C++... A good start would be to also adding adding a CONTRIBUTING.md (see this, especially the last 4 sections - warning: it's not the nixos/nix repo! -, and scour their readme too)
- Nixpkgs manual - Chapter 24. Contributing to this documentation
NixOS manual - [Chapter 72. Contributing to this manual](https://nixos.org/manual/nixos/stable/index.html#c

toraritte / learning_week-3.md

Created August 8, 2022 00:46

learning notes between 8/1 and 8/7 of 2022 (week 3 of Summer of Nix 2022)

While trying to define the term "Nix" (in a pedantic way):
- GitHub: NixOS/nix pull request #6420
- Discourse: Nix-this, nix-that, nix-what?
- What is a "paradigm"?
  - Google search: paradigm
  - Google search: paradigm vs paradigm shift
  - wikipedia: Paradigm
  - Wikipedia: Paradigm_shift
https://www.kbmanage.com/concept/paradigms#:~:text=Paradigms%20are%20generally%20defined%20as,company%20strategies%20and%20industry%20cycles.

toraritte / nixos-wiki-contrib_week-3.md

Created August 8, 2022 00:18

nixos.wiki edits between 8/1 and 8/7 of 2022 (week 3 of Summer of Nix 2022)

19:05, 6 August 2022 (diff | hist) . . (+89)‎ . . m Talk:Steam ‎ (Add signature to my note) (current)
19:05, 6 August 2022 (

toraritte / re-worked_fetchGit_docs.md

Created August 1, 2022 02:02

Re-imagining the documentation for Nix's `builtins.fetchGit`

The original builtins.fetchGit docs; see also comment in Nix issue #5128.

builtins.fetchGit referenceToGitRepo -> storeResult

Fetch a Git repo.

0. Pseudo Types

toraritte / fetchGit-weird-outputs.md

Last active July 28, 2022 14:26

`builtins.fetchGit` weird behaviour

Some context at the very beginning:

[~/clones/leftpad]$ git log --pretty=oneline --all
db1442a0556c2b133627ffebf455a78a1ced64b9 (HEAD -> master, tag: v0.0.1, origin/master, origin/HEAD) chore(release): 0.0.1
2cc67dc48e3a60ee9702ad01ac932c3ae5565d28 test: Add test suite with jsverify
6d086b454204e570d78c3d8d005e1d14f0291635 Create license
80683e5129cc49e4508d095ed77e6ec1dea65e37 (origin/greenkeeper/initial) docs(readme): add Greenkeeper badge
6f334bd795c1184e4de837968e13cfbdcaae6bd3 Repo and fix

toraritte / fetchGit.md

Last active July 27, 2022 02:40

Fetch a Git repo.

Types

referenceToGitRepo = URL | path | gitArgs

URL = httpURL | httpsURL | ftpURL | fileURL

httpURL = string\

toraritte / nix-build-result.md

Created July 22, 2022 04:05

result
├── bin
│   ├── nix
│   ├── nix-build -> nix
│   ├── nix-channel -> nix
│   ├── nix-collect-garbage -> nix
│   ├── nix-copy-closure -> nix
│   ├── nix-daemon -> nix
│   ├── nix-env -> nix

toraritte / erlang-glossaries.md

Created November 27, 2021 01:34

Erlang glossaries