2 ms·
I enjoyed that! I also enjoyed this: https://blog.griffin.sh/2020/04/17/making-decisions/ https://blog.griffin.sh/2020/04/17/making-decisions/ I know it’s bas
by ChrisMarshallNY 6y ago
I enjoyed that!
I also enjoyed this: https://blog.griffin.sh/2020/04/17/making-decisions/ https://blog.griffin.sh/2020/04/17/making-decisions/
I know it’s basically promotional material, but it’s pretty classy stuff. I wouldn’t mind if most corporations did the same.
I think a good exercise for me would be to do something similar.
I do have this, but it is not really the same kind of thing: https://medium.com/chrismarshallny/leaving-a-legacy-1c2ddb0c8014 https://medium.com/chrismarshallny/leaving-a-legacy-1c2ddb0c...
I try to have a casual voice in the vernacular. It pains me to use technical documentation as a soporific.
I got used to breaking up my writing into small paragraphs; often single sentences, when I worked for a Japanese company.
Another exercise that I have started doing in my writing, is to exchange the word “you” with “I” or “we.” I have found that people tend to react a bit negatively to a dictatorial tone.
Editing, for me, is a kind of ongoing process, and I will revise a document continuously after publication; sometimes, finding typos or suspect grammar weeks later.
I often continue to fact-check, and will do things like correct links, or add “after the fact” updates with additional information, errata, or elucidation.