• floofloof@lemmy.ca
    link
    fedilink
    English
    arrow-up
    14
    ·
    edit-2
    10 days ago

    This is how I, a developer with 25 years’ experience, still read many software tutorials. And I have a relatively high tolerance for technical detail. Often it seems the person writing the tutorial is in too deep, and they should have got a friend to write it with their help.

    • Jesus_666@lemmy.world
      link
      fedilink
      English
      arrow-up
      11
      ·
      9 days ago

      The annoying bit is that sharing a series of cryptic shell commands is typically the most efficient way of telling someone how to get things done and of keeping them from wandering off in the GUI and doing something else instead.

      This…

      # dos2unix your-file.ini | crunchmeister-cli frobulate -d 9 --exclude-preflight alpha,delta --wank > ~/.config/somethingd/frobulated.dat && systemctl --user restart somethingd

      …could be the equivalent of this.

      1. Convert your raw data INI file to UNIX file endings using an appropriate tool (outside the scope of this tutorial)
      2. Launch CrunchMeister
      3. Enter the Frobulation section and navigate to Custom Frobulation
      4. In the Input Data tab, upload the UNIXified INI file and set the data level to Full, with semicolons
      5. In the Preflight tab, ensure that the Alpha and Delta packages are deselected. Starting with CrunchMeister 5.7, the Delta package is found under the Additional packages expander
      6. In the Frobulate tab, enable wankness and hit the Frobulate! button
      7. Save the resulting file to your disk
      8. Launch Something Service Manager (install first if nor present)
      9. Click New frobulated data file
      10. Select the file you saved in step 6
      11. Click Reload service

      It’s still cryptic, though. You can’t have everything.

    • AnarchistArtificer@slrpnk.net
      link
      fedilink
      English
      arrow-up
      2
      ·
      9 days ago

      I appreciate comments like yours, and various others echoing the same sentiment in this thread and the HN thread. I’m far more proficient with techy stuff than the vast majority of people, but it’s easy to feel incompetent if you’re exposed to challenges outside of your primary domain (a feeling exacerbated by hanging out in spaces where most people seem to be super techy). It’s validating to hear that even people far more experienced than me struggle with tutorials sometimes.