4 ms·
Maybe it could be better written, but their advice gels with how I try to approach technical writing. The most common problem I see are authors packing too many
by scott_s 14y ago
Maybe it could be better written, but their advice gels with how I try to approach technical writing. The most common problem I see are authors packing too many concepts or facts into a single sentence. The writing becomes difficult to read for a reason that I was aware of, but could not articulate until I read this piece: readers are searching for syntactic closure. The more stuff - no matter how important - you put inbetween the subject and verb, the harder it is to read. The way I think about it is that until the reader gets that syntactic closure, all new words go into a temporary buffer. If that buffer spills before reaching closure, the reader is lost.
I encounter this in CS papers I read and co-author frequently. My most common editing remark is "split into two sentences."