2 ms·
This may sound pedantic, but I wish that these type of technical screeds were created with the flexibility/power of online publishing in mind. There needs to b
by danso 14y ago
This may sound pedantic, but I wish that these type of technical screeds were created with the flexibility/power of online publishing in mind.
There needs to be more thought given to the use of non-prose in communicating these things. More tables, a la Ed Tufte's principle of direct comparison and small multiples, is a huge help. At the very least, it helps break up dense text and forces the author to be more aware of how to best not bury important statements and assertions.
But if you aren't going to go all-in and use tables/graphics because it's a bit of work...then at least use headings, bulleted lists, formatted-text...this is the web, after all.
Or, if you don't even want to do that, at least use line breaks like everyone learns about.
And if you plan on including code, please use a wide enough format (and of course, syntax highlighting, though that is additional overhead).
I don't mean to belittle this author's point on the basis of visual cues alone. It's just that I see a lot of great essays that could be so much more influential and effective with just some additional effort put into presentation.