#2 The guide is badly out of order for actual new people.

Opened by cellarroot on May 21, 2023
cellarroot on May 21, 2023

Literally the guide walks you through things out of order. Like a stack trace this is end first beginning last:

  1. pijul identity is not even in there and you have to Sherlock Holmes it out when you see pijul key.
  2. pijul key generate doesn’t exist. It’s pijul identity new. Luckily the pijul help identity output is actually:–like good. It’s short enough you’re not in a labyrinth of hell. Pijul as it is now is already better than git in this regard.
  3. I’m forgetting but there was more weirdness. Like I couldn’t follow the Manual again because I hadn’t proven myself to ssh.pijul.com. Which was weird and out of order at the “Ch. 5 Working with Others” tutorial section.
  4. I also didn’t know that I had to click around nest to create the repos there. I was hoping I could make them and push them locally after proving. That’s probably more controvertible though.

any else weirdnesses? Favorable note: The install into WSL was nice and smooth like something people have down smooth. I appreciated that. I considered getting Nix so I could have the same process on WSL and Mac OS X.

my work has a TLS intercepting proxy so I’m avoiding that crap until I know what I’m doing at home. That thing sucks majorly for all DevOps compiling type processes. Everything is a web client and webclients are browsers that need manual config EACH! And the World Trusted Roots Lists per tool are not centralized because they’re not supposed to be updated by companies internal CAs. Or so community run software libraries seem to think.

cellarroot on May 21, 2023

The working with others section needs proper bootstrapping warnings before getting into Nest. Ahhh I remember now! It was Nest that was also weird as hell. And Discourse.pijul.com.

  1. Nest.pijul.com and ssh.pijul.com have an ambigious relationship. I assumed and then got nervous that they were not just the same thing for a bit there.
  2. Discourse.pijul.com can’t do OAuth. I had to do a local password. I wish I could submit a video or at least screen shots to this here discussion.
  3. Nest needs a password to delete repos even though I didn’t make one when I signed up because I signed up with my OAuth provider. (google specifically. Not sure that matters.) This wasn’t the end of the world because it let me set a new password pretty easily; but it was weird and kind of a hassle I specifically hate, (remembering a million passwords, OR, keeping them in some kind of accessible database that I don’t have to pay for)
cellarroot on May 21, 2023

Ok so the Manual needs to acknowledge that an edited down Getting Setup Before You Record“ section with stuff about

  1. [authors],
  2. pijul identity new <yourname>
  3. and remembering to get your ssh-keygen sorted out if you’re going to be using the Nest section which is later on.