29

How do you folks prefer to consume how-to’s and walkthroughs?

I’m starting to document how-to guides for people passionate about IT (who maybe are a little bit too into it) that like to run enterprise-grade systems at home.

Basically, I’m publicising my documentation for setting up systems and the weird problems I hit that may have taken me days or weeks to solve. Often this information isn’t able to be searched online or has little to no vendor documentation on how to solve it. Basically, I’m hoping my suffering means someone else might not have to if I share this stuff.

At this stage I’m putting everything into a blog, but I know how annoying it is to see posts on platforms like Lemmy that are a hyperlink and a bare post. So how would you prefer to see it?

I’ve considered a few options, each with negatives and positives but largely it distils to:

  1. Don’t overthink it, just post the link and if people don’t want to click it they won’t
  2. Duplicate the content of the blog post to the lemmy post (means double-handling the edits when the post has to be updated but preserves the info in the event the blog dies)
  3. Post the link and put a high level breakdown of the guide in the lemmy post, just enough that people get the main idea and they can follow the link for more details if they choose (more work as it means writing the post essentially twice, just more condensed)

What do you folks think?

top 12 comments
sorted by: hot top controversial new old
[-] ASeriesOfPoorChoices@lemmy.world 15 points 1 year ago

Personally, I prefer to read up front. If I need more info, then I'll go to the attached video / blog.

If there's no text, I often won't bother with the video/etc at all.

Side note: actually putting content in Lemmy is good for Lemmy, so search engines will start to pick it up.

[-] Tealk@rollenspiel.forum 11 points 1 year ago* (last edited 1 year ago)

Don’t overthink it, just post the link and if people don’t want to click it they won’t

I think that's the easiest way.

[-] MxRemy@lemmy.one 5 points 1 year ago

I definitely prefer 2 or 3. Especially 2, but whichever is easier for the poster is fine.

[-] Kissaki@feddit.de 5 points 1 year ago

Post should include a description/summary/teaser.

[-] MigratingtoLemmy@lemmy.world 4 points 1 year ago
  1. Stuff the title with the most number of keywords (SEO on Lemmy)
  2. Short summary of the problem and the solution (maybe) - same as the overview in the blog post.
  3. Link.
  4. Preferably a github repo so someone searching directly on there can find it
[-] mp3@lemmy.ca 3 points 1 year ago

I'd rather see the how-to live somewhere that is expected to last and where it may stay online for a while.

If the how-to is valuable to me, I'll make a copy of it in my documentation and also submit the page to the Wayback Machine just in case it is taken down, the host ceases to exist, etc.

I prefer my how-tos to be Markdown-based, they're easy to edit and the text will reflow well on small screens unlike a PDF.

[-] Valmond@lemmy.mindoki.com 2 points 1 year ago

I'm old and prefer a well written document over video.

[-] Gnorv@feddit.de 2 points 1 year ago

Tell me you did not read the post without telling me you did not read the post.

[-] rufus@discuss.tchncs.de 2 points 1 year ago* (last edited 1 year ago)

I like #3.

If it's something like a knowledge database a wiki would be better suited. You can organize stuff in a tree-like structure and people can edit stuff instead of having convoluting discussions inbetween your writings/comments.

You could just start here, write like 5-10 howtos and see if people like it. You'll get to know if people like it and what exactly works and what doesn't. You can then simply move the stuff to a wiki once you have enough content ready and it won't look that empty. You can then edit your 10 posts and link to the wiki. This approach works without speculating.

[-] Bebo@literature.cafe 1 points 1 year ago

2 or 3. Either would work.

[-] Sneezydinosaur@lemmy.world 1 points 1 year ago

You could always do 1, then access the site through the way back machine so they have a saved copy in case the blog goes down. That's usually my first check when a guide I need has gone down.

[-] spaghetti_carbanana@krabb.org 1 points 1 year ago

Thanks everyone! I think what I’ll end up doing here is posting the guide directly into lemmy as a condensed version of the full article, then link to the article which will have screenshots and more background.

this post was submitted on 06 Nov 2023
29 points (93.9% liked)

Asklemmy

43822 readers
895 users here now

A loosely moderated place to ask open-ended questions

Search asklemmy 🔍

If your post meets the following criteria, it's welcome here!

  1. Open-ended question
  2. Not offensive: at this point, we do not have the bandwidth to moderate overtly political discussions. Assume best intent and be excellent to each other.
  3. Not regarding using or support for Lemmy: context, see the list of support communities and tools for finding communities below
  4. Not ad nauseam inducing: please make sure it is a question that would be new to most members
  5. An actual topic of discussion

Looking for support?

Looking for a community?

~Icon~ ~by~ ~@Double_A@discuss.tchncs.de~

founded 5 years ago
MODERATORS