Top all-time · #19469
KnowledgeOwl
Company blog · knowledgeowl.com/blogwritingproductivity
KnowledgeOwl is the company blog at knowledgeowl.com, writing about writing and productivity. Since 2022, 4 different Hacker News readers have linked it 5 times. No feed was found, so read it on the site itself.
Too few sampled comments (3) to say how often HN recommends it.?
Why HN links it
HN readers link KnowledgeOwl's blog for technical writing advice, such as a guide on how readers' brains process information and a post arguing against using the word 'simply' in documentation.
Summarised by Claude from a sample of 3 HN comments that link here. Each comment is marked recommending, critical or neutral (citing without judging); how this works.
KnowledgeOwl provide easy to use software to share information quickly with your customers and staff.
Most-linked posts?
- /blog/posts/dont-say-simply-jim-fisher/2 people · 2 mentions · first linked 2023-02-27
What Hacker News says?
To more impactful convey they information, keep not only the audience in mind, but also how their brains will process that information. Then tailor content to make it easy for the receiving entity (brain) to process the information and store it effectively. I found this guide helpful: https://www.knowledgeowl.com/home/three-tips-psychology-docu...
Comment linking /home/three-tips-psychology-documentation
on “Ask HN: How to level up your technical writing?”Submitted Support queue is a documentation audit as a story · 1 points
HN discussionIt's a more and more popular opinion: - Why not tell people to "simply" use pyenv, poetry or anaconda ( https://bitecode.substack.com/p/why-not-tell-people-to-simpl... ) - Don’t use the word ‘simply’ ( https://jameshfisher.com/2017/02/22/dont-use-simply/ ) - Stop using ‘simply’ in tech instructions ( https://www.parkersoftware.com/blog/stop-using-simply-in-tec... ) - Don’t say “simply” in your documentation ( https:…
Comment linking /blog/posts/dont-say-simply-jim-fisher/
on “Just Simply – Stop saying how simple things are in our docs”Submitted Writing clear docs when you naturally think in code as a story · 1 points
HN discussionThe gp is quibbling about the overuse of the adjectives "just" or the more common "simply" to qualify multiple actions, which are often not simple . See Avoid "Just" and "Simply" in Documentation http://jackkelly.name/blog/archives/2019/09/20/avoid_just_an... Don’t say “simply” in your documentation by Jim Fisher https://www.knowledgeowl.com/blog/posts/dont-say-simply-jim-...
Comment linking /blog/posts/dont-say-simply-jim-fisher/
on “Help! Is This Arabic?”