2 ms·
I treat writing like I do programming. My goal is to get the interpreter (i.e. the reader) to properly parse and understand the idea I'm trying to convey. As su
by falcolas 9y ago
I treat writing like I do programming. My goal is to get the interpreter (i.e. the reader) to properly parse and understand the idea I'm trying to convey. As such, I try and keep everything simple and on point, freely go back and refactor sentences which don't make sense, and read the content back in my head to see if the words I wrote even make sense to me.
The only other rule I really use is to write for as low level of an audience as I can. This helps to reduce confusion for the readers, not all of whom may have the same vocabulary or "state" as you. You don't want to write about concepts from CS 401 when your readers are in CS 101, especially if the CS 401 concepts are not required for understanding.
Oh, and avoid un-delimited sarcasm. It travels really poorly through the internet; someone will always take it at face value.