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.
Or read this on Hacker News