Writing Blog Posts Developers Actually Read

2025-03-28
Writing Blog Posts Developers Actually Read

A developer gave up blogging due to low readership. Author Michael Lynch shares nine years of blogging lessons, highlighting common mistakes: rambling introductions, unclear benefits, and neglecting audience reach. He advises clearly stating the target audience and benefits upfront, considering broadening the appeal, and planning the reader's path to discovery. Using visuals, strong headlines, and considering different platforms for sharing are also key to success.

Read more
Development

Rules for Writing Kickass Software Tutorials

2025-01-02
Rules for Writing Kickass Software Tutorials

This blog post outlines rules for crafting exceptional software tutorials. It highlights the importance of avoiding jargon, clearly stating goals, providing copy-pasteable code snippets, maintaining a working code state, and minimizing dependencies. The author uses contrasting examples to illustrate the differences between good and bad tutorials, offering practical improvements such as using long command-line flags, separating user-defined values from reusable logic, and employing consistent, descriptive headings. The ultimate aim is to create beginner-friendly tutorials that are easy to understand and follow.

Read more