Writing Like You Code: The Intersection of Good Writing and Efficient Coding
Hatched by Kazuki Nakayashiki
Aug 12, 2023
4 min read
3 views
Writing Like You Code: The Intersection of Good Writing and Efficient Coding
In the world of writing and coding, there are striking similarities when it comes to what constitutes good and bad practices. Both good writing and good code share characteristics such as simplicity, efficiency, and structure. On the other hand, bad writing and bad code can be complex, inefficient, and resemble a tangled mess. Drawing parallels between these two disciplines can help us understand how to improve our writing and coding skills. Let's explore some of these common points and discover actionable advice to enhance our abilities.
One of the fundamental principles in coding is to strive for simplicity. Similarly, in writing, it is essential to avoid unnecessary complexity. Just like a junior engineer should be able to understand good code, a reader should be able to comprehend well-written content without any confusion. If something doesn't need to be said, it's best to omit it. This approach aligns with the idea that the best code is no code at all. By applying this principle to writing, we can ensure that our message is clear and concise, saving the reader's mental resources.
Consider the reader's attention span and memory as the writer's equivalent of CPU cycles and RAM. Good writing combats boredom by incorporating humor or providing insightful moments for the reader. A helpful technique to keep readers engaged is to offer them an epiphany every 250 words, as coined by David Perell, known as the "Raymond Chandler rule." By structuring our writing in a way that captivates the reader's attention at regular intervals, we can create a more enjoyable and memorable reading experience.
In the startup world, there is a concept of "super founders" who have a higher likelihood of success. Interestingly, the characteristics of these super founders can also be applied to writing. Most founders don't have direct industry experience in the field they disrupt. Similarly, writers can tackle diverse topics without being experts in those areas. This opens up opportunities for exploration and fresh perspectives. Additionally, experience in other startups or corporate environments may not always be relevant, as long as the writer brings a unique viewpoint to the table.
When it comes to building successful startups, certain factors contribute to their growth. Engineering and network effects are considered the most defensible aspects. Similarly, in writing, the product matters. Having a high level of differentiation in the core offering can make a piece of writing stand out among competitors. Just as startups aim to gain market share, writers should focus on capturing the reader's attention and providing value in a crowded content landscape.
Productivity is a key category in successful startups, where the goal is to help companies or individuals achieve their objectives more efficiently. In writing, the same principle applies. By providing practical advice, actionable tips, or insights, writers can enhance the reader's productivity in various aspects of life and work. This approach resonates with readers and ensures a valuable experience.
Now that we have explored the intersections between writing and coding, let's conclude with three actionable pieces of advice:
-
Embrace simplicity: Strive for clarity and avoid unnecessary complexity in your writing. Just as good code is simple and easily understood, good writing should be accessible to a wide range of readers.
-
Engage the reader: Incorporate humor, insightful moments, and regular epiphanies to maintain the reader's attention. By structuring your writing to captivate the reader at regular intervals, you can create a more enjoyable and memorable reading experience.
-
Differentiate your content: Just as startups aim to differentiate their core product offering, strive to provide unique value in your writing. Focus on product differentiation by offering fresh perspectives, practical advice, and actionable insights to stand out among competitors.
In conclusion, the relationship between writing and coding goes beyond the surface level. By applying principles from coding, such as simplicity, efficiency, and structure, writers can enhance their craft. Understanding the parallels between these disciplines allows us to improve our writing by considering the mental resources of the reader, engaging them through humor and insights, and delivering valuable and differentiated content. So, let's embrace the notion of "writing like you code" and create compelling and efficient written pieces that resonate with readers.
Sources
Hatch New Ideas with Glasp AI 🐣
Glasp AI allows you to hatch new ideas based on your curated content. Let's curate and create with Glasp AI :)
Start Hatching 🐣