Orwell would have written superb API documentation.

(Even if every deprecated end-point was described having a faint smell of boiled cabbage.)

Come on, this is not Joycean or Faulknerian stuff.

Not quite. Many authors hot the mark for me. Neil gaiman, Stephenson, Peter Watts, doctorow, all write prose eloquently without getting obtuse.