Episode 506

Ask Noah Show 506

September 15th, 2026

53 mins 53 secs

Link with Timestamp

Download MP3 (37 MB)

Your Hosts

About this Episode

This week Steve gives the deep dive into the reason and the how for documentation. It's an essential thing in any IT environment, it doesn't get nearly enough love so we shine a spotlight on it.

-- During The Show --

00:45 Intro

  • Sound effects
  • RPG Web UI
  • Never Winter Nights
  • Kansas City
  • Steve and traveling

09:18 News Wire

10:30 Documentation

  • Document "why" something was done
  • Assumption and argument
  • What needs to be documented
  • Reproducer - Blow it away and set it up again
  • Document everything
  • Why do people resist documenting
  • Executive vs Technical Summaries
  • Tribal knowledge
  • Styles of documentation
  • White papers
  • CMA
  • What should you NOT document
  • Process of documenting
  • Where do you document
  • Wiki.js
  • Markdown
  • Steve's container documentation
  • Steve's GitHub
  • Steve's Red Hat profile
  • Hackaday

-- The Extra Credit Section --

For links to the articles and material referenced in this week's episode check out this week's page from our podcast dashboard!

This Episode's Podcast Dashboard

Phone Systems for Ask Noah provided by Voxtelesys

Join us in our dedicated chatroom #GeekLab:linuxdelta.com on Matrix

-- Stay In Touch --

Find all the resources for this show on the Ask Noah Dashboard

Ask Noah Dashboard

Need more help than a radio show can offer? Altispeed provides commercial IT services and they’re excited to offer you a great deal for listening to the Ask Noah Show. Call today and ask about the discount for listeners of the Ask Noah Show!

Altispeed Technologies

Contact Noah

live [at] asknoahshow.com

-- Twitter --

Support Ask Noah Show