HN Atlas
← All topics

Writing and technical documentation

Writing craft, editing, publishing, technical documentation, and communicating ideas clearly.

8,595 stories · 103 in 30 days · Updated Sep 28, 2026

The pace of conversation

Posts per month

2020-01: 124 posts2020-02: 110 posts2020-03: 107 posts2020-04: 111 posts2020-05: 162 posts2020-06: 140 posts2020-07: 137 posts2020-08: 117 posts2020-09: 100 posts2020-10: 129 posts2020-11: 124 posts2020-12: 101 posts2021-01: 129 posts2021-02: 78 posts2021-03: 123 posts2021-04: 75 posts2021-05: 122 posts2021-06: 102 posts2021-07: 71 posts2021-08: 63 posts2021-09: 97 posts2021-10: 95 posts2021-11: 91 posts2021-12: 95 posts2022-01: 113 posts2022-02: 92 posts2022-03: 94 posts2022-04: 98 posts2022-05: 102 posts2022-06: 118 posts2022-07: 108 posts2022-08: 117 posts2022-09: 95 posts2022-10: 94 posts2022-11: 127 posts2022-12: 101 posts2023-01: 119 posts2023-02: 107 posts2023-03: 115 posts2023-04: 92 posts2023-05: 100 posts2023-06: 96 posts2023-07: 95 posts2023-08: 99 posts2023-09: 80 posts2023-10: 98 posts2023-11: 99 posts2023-12: 112 posts2024-01: 110 posts2024-02: 120 posts2024-03: 112 posts2024-04: 97 posts2024-05: 100 posts2024-06: 75 posts2024-07: 91 posts2024-08: 82 posts2024-09: 100 posts2024-10: 100 posts2024-11: 96 posts2024-12: 89 posts2025-01: 131 posts2025-02: 101 posts2025-03: 114 posts2025-04: 91 posts2025-05: 123 posts2025-06: 85 posts2025-07: 95 posts2025-08: 105 posts2025-09: 81 posts2025-10: 107 posts2025-11: 96 posts2025-12: 116 posts2026-01: 134 posts2026-02: 126 posts2026-03: 160 posts2026-04: 108 posts2026-05: 136 posts2026-06: 119 posts2026-07: 115 posts2026-08: 106 posts2026-09: 100 posts
2020-012026-09

Posts per month · first and latest months may be partial.

01 / EXPLORE THROUGH TIME

Timeline

Start with the latest. Scroll back through time, or zoom in for more.

Year by yearUp to 5 stories per year
20261,104 stories
I don't want to read what you didn't write↗ blog.colinbreck.com · HN · 459 comments · 1068 points · Sep 21, 2026
To become a better writer, read as much as you can↗ nappertime.com · HN · 264 comments · 486 points · Aug 23, 2026
Writing by hand is good for your brain↗ nealstephenson.substack.com · HN · 668 comments · 1491 points · Jul 23, 2026
Time to talk about my writerdeck↗ veronicaexplains.net · HN · 294 comments · 517 points · May 23, 2026
Do your own writing↗ alexhwoods.com · HN · 239 comments · 748 points · Mar 30, 2026
20251,245 stories
You should write an agent↗ fly.io · HN · 395 comments · 1070 points · Nov 06, 2025
How to post when no one is reading↗ jeetmehta.com · HN · 252 comments · 670 points · Jun 02, 2025
I'd rather read the prompt↗ claytonwramsey.com · HN · 839 comments · 1444 points · May 04, 2025
Why blog if nobody reads it?↗ andysblog.uk · HN · 359 comments · 770 points · Feb 09, 2025
Ingesting PDFs and why Gemini 2.0 changes everything↗ sergey.fyi · HN · 447 comments · 1303 points · Feb 05, 2025
20241,172 stories
Diátaxis – A systematic approach to technical documentation authoring↗ diataxis.fr · HN · 113 comments · 514 points · Dec 05, 2024
A return to hand-written notes by learning to read and write↗ research.google · HN · 181 comments · 595 points · Oct 28, 2024
Why I still blog after 15 years↗ jonashietala.se · HN · 226 comments · 493 points · Sep 25, 2024
How to write stuff no one else can↗ thewritetoroam.com · HN · 132 comments · 527 points · Feb 09, 2024
Standard Ebooks↗ standardebooks.org · HN · 153 comments · 701 points · Jan 01, 2024
20231,212 stories
Docs Deserve More Respect↗ ramijames.com · HN · 71 comments · 104 points · Dec 28, 2023
Writing Code Is the Same Thing as Writing Prose↗ gybe.ca · HN · 51 comments · 34 points · Dec 25, 2023
What happened to blogging for the hell of it?↗ blog.whiona.me · HN · 19 comments · 35 points · Oct 17, 2023
How to Write a Great Readme↗ appsmith.com · HN · 14 comments · 36 points · Jul 18, 2023
I don't read web articles anymore, but I read books↗ news.ycombinator.com · HN · 19 comments · 43 points · Jan 09, 2023
20221,259 stories
High-documentation, low-meeting work culture↗ tremendous.com · HN · 495 comments · 824 points · Nov 22, 2022
Standard Ebooks↗ standardebooks.org · HN · 256 comments · 1578 points · Jul 24, 2022
Writing one sentence per line↗ sive.rs · HN · 297 comments · 849 points · Jun 20, 2022
How to write more clearly, think more clearly, and learn complex material [pdf]↗ covingtoninnovations.com · HN · 153 comments · 779 points · Apr 17, 2022
Include diagrams in your Markdown files with Mermaid↗ github.blog · HN · 260 comments · 903 points · Feb 14, 2022
20211,141 stories
Nerds don't respond to marketing; try technical documentation instead↗ hackernoon.com · HN · 238 comments · 345 points · Aug 14, 2021
Google Docs will now use canvas based rendering↗ workspaceupdates.googleblog.com · HN · 930 comments · 1167 points · May 12, 2021
Writing books is not really a good idea↗ ellegriffin.substack.com · HN · 609 comments · 577 points · May 10, 2021
Write Simply↗ paulgraham.com · HN · 330 comments · 484 points · Mar 11, 2021
A Framework for Writing Better Documentation↗ documentation.divio.com · HN · 76 comments · 637 points · Feb 02, 2021
20201,462 stories
Writing a book: is it worth it?↗ martin.kleppmann.com · HN · 287 comments · 642 points · Sep 29, 2020
How to Write in Plain English↗ plainenglish.co.uk · HN · 313 comments · 724 points · Aug 25, 2020
I Am Deleting the Blog↗ slatestarcodex.com · HN · 1515 comments · 2450 points · Jun 23, 2020
Ask HN: What is your blog and why should I read it?↗ news.ycombinator.com · HN · 655 comments · 910 points · Apr 07, 2020
How to Write Usefully↗ paulgraham.com · HN · 285 comments · 821 points · Feb 21, 2020
Scroll through time ↕

02 / CATCH UP

The conversation now

Popular stories, with attention fading over roughly two weeks.

I don't want to read what you didn't write↗ blog.colinbreck.com · HN · 459 comments · 1068 points · Sep 21, 2026
Chopping up books when they're physically too big↗ attainablefelicity.mattkirkland.com · HN · 211 comments · 229 points · Sep 15, 2026
To become a better writer, read as much as you can↗ nappertime.com · HN · 264 comments · 486 points · Aug 23, 2026
Experiencing writing at our recent Chinese calligraphy workshop↗ viewsproject.wordpress.com · HN · 1 comments · 38 points · Sep 24, 2026
To write non-fiction, draw the trunk, then the rest of the tree↗ devz.cl · HN · 34 comments · 115 points · Sep 08, 2026

03 / GO DEEPER

Follow your curiosity

Find a particular story, revisit a year, or see what resonated.

Highest rated · the last 30 days

I don't want to read what you didn't write↗ blog.colinbreck.com · HN · 459 comments · 1068 points · Sep 21, 2026
Chopping up books when they're physically too big↗ attainablefelicity.mattkirkland.com · HN · 211 comments · 229 points · Sep 15, 2026
To write non-fiction, draw the trunk, then the rest of the tree↗ devz.cl · HN · 34 comments · 115 points · Sep 08, 2026
Ending my elixir exploratory writing↗ lucassifoni.info · HN · 46 comments · 74 points · Sep 02, 2026
Experiencing writing at our recent Chinese calligraphy workshop↗ viewsproject.wordpress.com · HN · 1 comments · 38 points · Sep 24, 2026
Why do so many tools have JSON config files?↗ textlog.cc · HN · 71 comments · 23 points · Sep 02, 2026
Show HN: SlideOps – slides from a repo that flag when they drift from the code↗ github.com · HN · 5 comments · 23 points · Aug 31, 2026
Show HN: DaiDocs, AI memory as a plain-text file format, not a service↗ github.com · HN · 1 comments · 8 points · Sep 15, 2026
Why This Author Doesn't Publish Technical Articles Anymore↗ galratner.substack.com · HN · 3 comments · 8 points · Sep 12, 2026
Write While Learning↗ purplesyringa.moe · HN · 0 comments · 6 points · Sep 19, 2026

10 stories shown.

Help shape Hacker Atlas

Useful, confusing, or missing something? I’d love to hear.

Your feedback is private. Your email is only used to reply, never to sign you up for a newsletter.