Get the latest tech news

Let's Talk About Writing in Tech


Confusing documentation and tutorials: possible causes and solutions

2024 Stack Overflow listed technical documentation and written tutorials as two of the top three resources for learning to code. Despite this I’m sure you’ve experienced (likely more than once) that frustrating moment when you finish reading a tutorial or documentation and feel even more confused than when you started. Actually in 2017, GitHub's Open Source Survey showed "incomplete or confusing documentation" to be the top pain point.

Get the Android app

Or read this on Hacker News

Read more on:

Photo of tech

tech

Related news:

News photo

How the Music Industry is Building the Tech to Hunt Down AI-Generated Songs

News photo

Australia social media teen ban software trial organisers say the tech works

News photo

ICE seeks proprietary data and tech to monitor up to a million people