logoalt Hacker News

imtringuedtoday at 8:30 AM1 replyview on HN

This poetic form of writing "reads well", but it completely failed to convey the idea to me. I had to read the blog multiple times to get the point, because poems are not meant to be direct, unambiguous or simple to understand.

From a technical writing perspective, this is a terrible blog post.

Here is a better blog: https://cloud.google.com/blog/topics/developers-practitioner...


Replies

0xDEAFBEADtoday at 11:17 AM

The maximally concise formulation is not always maximally understandable.