Hacker News new | past | comments | ask | show | jobs | submit login

Though this isn't a specific reading, there is a useful habit you can try out: you can start to regularly read well-written newspaper articles, because a focus of written journalism is to break down complex issues into understandable stories. These can provide exemplars for how to approach your own writing.

Consider a recent article in the Financial Times about rising sea temperatures [1][2]. The topic is vast and complicated, which is perhaps relatable to your perspective, yet it's the job of the writer to produce the linear narrative that you mentioned. How does the writer do this?

---

The article presents the key idea up front with a headline ("The dangerous effects of rising sea temperatures"), and then adds context with a sub-headline ("Scientists are increasingly concerned that the world’s oceans are approaching the limits of their capacity to absorb heat").

To ease the reader into the topic, the author then begins by focusing on a human subject by writing: "In 30 years of studying the oceans, Matthew England has learnt to understand their irregular yet constant rhythms — the cycles of wind, temperature and atmospheric changes that interact with the masses of water covering most of the Earth’s surface.

The author continues: "But what he has seen in the past 15 months has shocked him. Global sea surface temperatures have reached and stayed at record levels, fuelling heatwaves and melting sea ice. Temperatures in the north Atlantic waters he has been studying, including around the UK and Ireland, were described last year as “beyond extreme” by the EU’s Earth observation service."

The author later "zooms out" as a narrative technique—similar to the one described in the submitted article—that provides wider context for the problem that the interviewee is describing by presenting cases of natural disasters.

To get deeper into the subject, the author then includes perspectives from various other researchers who study the phenomenon, and then dives deeper into competing theories about the immediate causes behind these environmental changes.

---

So, in your context, you could begin describing how your software tool solves some problem by describing a human user who is facing a specific yet common issue that is frustrating. After the reader then grasps what the problem is, you could write about how your software tool fixes the problem.

But this is just one approach of many. Another author might have taken a "lede-nut graf" [3] approach, where the bottom-line conclusion is put in the first sentence as the "lede," followed by the "nut graf" of a paragraph providing additional context and motivation to read the rest of the article. With this approach, you could skip the focus on a human user, and instead jump right into a sentence that claims your software tool solves a specific problem (especially if the problem is a well-known one).

One of the best methods I've found to get better at a particular skill is to immerse yourself in high-quality exemplars of what you're trying to do. Even without taking notes, you can naturally pick up lessons from what you're experiencing. For this reason, a habit of reading well-written articles could help with your own ability to describe complicated concepts in a way that's more accessible.

[1] Link: https://www.ft.com/content/76c3747d-f068-467a-98f9-4ed687dcb...

[2] Gift link (viewable up to three times): https://on.ft.com/3LJJmBT

[3] More on nut grafs: https://www.theopennotebook.com/2014/04/29/nailing-the-nut-g...




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: