liveBook · Manning

Cropping

As explained in Writing for Developers: Blogs that get read

A writing technique that removes or narrows peripheral material to emphasize the most interesting or relevant part of an article.

Cropping narrows a drafted article around the detail most likely to interest readers. Remove peripheral material instead of asking one post to serve several purposes. section 5.2.2

Choose one compelling center, then cut or expand to support it:

  • Focus on the data migration tool and remove most of the Zig discussion. section 5.2.2
  • Focus on lessons learned from a first foray into Zig and reduce the migration-tool material. section 5.2.2
  • Focus on Zig’s strict type system, expanding that topic while cutting unrelated material. section 5.2.2

Use the photo test

Treat revision like cropping a photograph: trim distracting edges so the most interesting detail receives the reader’s attention. section 5.2.2

How Writing for Developers: Blogs that get read covers it

How deep it goes
Demonstrates a post-draft principle through three focus options, but stops short of a detailed revision checklist.
Examples
Uses a fictional Zig blog post about a data migration tool, Zig lessons, or Zig’s strict type system.
What it assumes
Assumes a drafted article and a sense of which details will interest its intended readers.
What you can do after
Apply it by choosing one article focus and removing or expanding material that does not serve it.
How it connects
Connects writing revision with photography, focus, reader attention, and topic expansion.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Writing for Developers: Blogs that get read. The section links point to the parts of the book it draws on.