I disagree with the premise that writing concisely is analogous to writing concise code. In fact, the opposite is more likely true. Why do we still have thousa

I disagree with the premise that writing concisely is analogous to writing concise code. In fact, the opposite is more likely true. Why do we still have thousands of poorly written program error messages of the meaningless 'invalid value' kind? Everyone immediately recognises this staccato style of writing common among developers. Even modern programming languages have terrible compiler error messages. (Rust has made a commendable effort to display readable English compiler error messages.) All this suggests to me that developers who write their English like their code are writing like a computer, not writing for other humans. --- Here are two recommendations for writing clear English (excludes fiction) : Plain English Campaign This is a campaigning organisation from the UK which promotes clear, easy-to-understand written English suitable for any industry or profession. Here is their clear, simple and short guide on How to write in plain English [PDF]: http://www.plainenglish.co.uk/files/howto.pdf http://www.plainenglish.co.uk/files/howto.pdf --- GOV.UK: 10 tips for clear writing I find the tips at the following link very helpful: https://gds.blog.gov.uk/2019/08/27/podcast-on-writing/ https://gds.blog.gov.uk/2019/08/27/podcast-on-writing/ You don't need to listen to the podcast at the top of the linked page (unless you want to). Scroll down the page and you'll find a short description of each of the following tips: 1. Establish ‘The Point’ 2. Write it like you’d say it 3. Don’t try to sound clever 4. Show the thing 5. Know that you are not your writing 6. Share your work 7. Read (poetry in particular) 8. Never start with a blank page 9. Know when enough is enough 10. Stay human