summaryrefslogtreecommitdiff
path: root/personal/writing.md
diff options
context:
space:
mode:
authorKévin Le Gouguec <kevin.legouguec@gmail.com>2019-07-11 18:10:53 +0200
committerKévin Le Gouguec <kevin.legouguec@gmail.com>2019-07-11 18:10:53 +0200
commit8cfe656fbb312398244d6f0e820d4f179db3cfc7 (patch)
tree31102175eb71b82eece64ba62cf494e1014b0fc9 /personal/writing.md
parent66d44f9dbb1f6a6e8af5d51677ee39c496c46caa (diff)
downloadmemory-leaks-8cfe656fbb312398244d6f0e820d4f179db3cfc7.tar.xz
Move some things around
Diffstat (limited to 'personal/writing.md')
-rw-r--r--personal/writing.md44
1 files changed, 0 insertions, 44 deletions
diff --git a/personal/writing.md b/personal/writing.md
deleted file mode 100644
index de68ed4..0000000
--- a/personal/writing.md
+++ /dev/null
@@ -1,44 +0,0 @@
-I worry a lot about how efficient my writing is. I want to keep it as
-straightforward (maximizing signal-to-noise ratio) and accurate
-(citing sources and assumptions) as I can.
-
-Since I keep catching myself making the same mistakes, and I do not
-have automated tools to warn me about them yet, I figured I should
-write down all the things I want to watch out for.
-
-# Decruftification
-
-## Sentences
-
-- Watch out for verbs which hide the action (e.g. try, allow).
-- Use simpler words as long as they are not more vague.
-
-## Mails
-
-- Pick your battles: people only have time for so many subjects.
- Focus on symptomatic relief; hint at systemic problems but wait
- until prompted before ranting.
-- Tricks to make mails more digestible:
- - condense the point(s) into a tl;dr;
- - move details (investigation, alternatives, rationale) into
- footnotes or attachments;
- - spin new threads.
-
-# Logic
-
-When expressing causation, check that all causes have been explicitly
-stated. Be wary of assumptions^[I felt like adding "protect yourself
-against misquotations", but those will probably happen anyway].
-
-Conversely, if C can be deduced from A alone, consider rewriting
-"since A and B, C" into "since A, C". Unnecessary Bs can be
-detrimental to the discussion and make it to go off-topic; beware:
-
-- humorous overstatements that might be taken seriously;
-- subconscious attempts at shoehorning a point that feels essential
- but is not actually relevant.
-
-# Resources
-
-- [IEEE's "Write Clearly and Concisely"](http://sites.ieee.org/pcs/communication-resources-for-engineers/style/write-clearly-and-concisely/)
-- [Gitlab's Technical Writing Handbook](https://about.gitlab.com/handbook/product/technical-writing/)