mastodon.social is one of the many independent Mastodon servers you can use to participate in the fediverse.
The original server operated by the Mastodon gGmbH non-profit

Administered by:

Server stats:

320K
active users

muesli

If you write a tutorial, don't cover up all the mistakes you made along the way. Include them in detail!

Reading a success story is nice, but as so often in life, you'll learn so much more from all the mistakes you make, and all the issues you run into... and so will your audience.

@fribbledom yup, can confirm. 👍

On one blog post I explained how I discovered Linux was a bad choice for an old iBook G4, then covered the limitations of the PPC build of OpenBSD that did actually work. The latter led to package fixes!

In my most recent post building a retrogaming PC, I mentioned initially bought the wrong sound card. I was thanked by somebody on birdsite (before I left) for saving them from the same mistake.

@fribbledom I could see this in a howto, but not in a tutorial. For a tutorial user, the project is likely to be dropped at the first stumbling point, and a deeper understanding is not the point of a tutorial.

@fribbledom I think you only learn from mistakes...

If something goes right you don't know if it was because of what you did or just chance...

But if it goes wrong, you certainly know what *not* to do!

@fribbledom Exactly!
This is the major mistake profs make in lecture too.
They do exactly the same perfect thing every time semester after semester instead of varying.
It's what I loved about the early vids on Kahn Academy - he recorded his mistakes and efforts to get to the solution.
Filling up a board and then slamming it over out of the way (or erasing it!) and saying that it's "trivial to derive yourself later" is bullshit arrogance.

@fribbledom when i replaced my battery for my psp(by modifying a retail hobby battery instead of using those awful chinese ones) the guide author covered all his mistakes and it was shocking how informative leaving those in was