raphlinus.github.io icon indicating copy to clipboard operation
raphlinus.github.io copied to clipboard

Thoughts on writing process

Open raphlinus opened this issue 5 years ago • 0 comments

I've been refining my writing process, and people have expressed interest.

  • Seek to minimize controversy. Most things exist as tradeoffs, emphasize positive side of tradeoff space. imgui would be a good example (partly because it's a chance to write down some "softer" thoughts on imgui)
  • Avoid emotionally charged language. Ableist and gendered language (when not needed) out.
  • When there's likelihood of confusion, circulate a draft and take feedback.
  • Have a queue, and have blogs in draft. This gives time to think about what I'm going to say. "compositor is evil" took 18mo. New plan: use issues to make this more explicit, encourage feedback earlier.
  • Target audience: a curious person who doesn't necessarily have a solid background. Take the opportunity to teach. (Contrast: "wall of greek" papers full of math content, seem to be more about showing off prowess)
  • Assume good faith, and ignore bad faith. (Mostly relevant in comment sections)
  • Generally I read the final draft aloud before publishing. Gives a chance to fix language poetry issues, rough transitions, missing pieces of the narrative.

A few thoughts on my "research" rebranding. In most case, the blog is the most efficient way to get research results out, with open source code as the artifact of record. I do occasional papers and conferences too.

raphlinus avatar Jan 06 '21 16:01 raphlinus