correspondence-about-nix-learning-journeys.md

@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:

  1. create an anonymous "user persona" to show how a user's background matters when they face the Nix eco-system and its current state of documentation for the first time (or even after getting some experience, as the studies - and my own experience - show)

  2. The embedded list format should be kept, but cleaned up by

     • removing any parts that could identify the user
     • fix typos
     • round out sentences
     • make certain parts more reader-friendly
     • explain what "intervention" and "prompt"s are
       • I'm kind of confused here too:
         • "intervention" seems to move along the interviewee from a particularly confusing part or, to put another way, get them "unstuck"
         • "prompt" seems to be a synonym for "Q:" but will them another read today

Thanks a lot! Attila

@fricklerhandwerk:

Exactly as you described, thanks for clarifying. We can reuse that as a preamble to the series if you reworded the questions to statements.

Q and prompt are almost the same, prompt essentially giving the person input what to do next to cover some specific ground, question to figure out what the person understood or to provoke a reaction or trail of thought.