Skip to content

Instantly share code, notes, and snippets.

@rauschma
Last active August 1, 2024 00:36
Show Gist options
  • Save rauschma/8a7b40b53f2240a96743d1cf79f08419 to your computer and use it in GitHub Desktop.
Save rauschma/8a7b40b53f2240a96743d1cf79f08419 to your computer and use it in GitHub Desktop.

My writing process

Stages of my writing process

  • Collecting material: For a number of topics that I may write about in the future, I have text files where I collect information as I come across it during coding, on the web, on Twitter, etc.

  • Outline: The collected material is my starting point. I rearrange it into an outline which I refine until I’m happy with it. Refining includes adding/removing/rearranging items and doing more research when I notice gaps in my knowledge.

  • Skeletal draft: I add bullet points and code examples until almost all of the content exists at least in skeletal form. This process often uncovers knowledge gaps and flaws in the structure of the content which I then can fix.

  • Draft: Once I’m certain that the information flow of the content works, I go through the skeletal draft and turn it into English.

  • Editing: I go through the draft and correct spelling mistakes and other problems I notice.

  • Publication

  • Revisiting the content: I often go through the content again later, e.g. when someone asks me a question, when someone suggests an improvement, or when I move content from my blog to a book. Each of these passes improves the content. Revisiting old content has the benefit of me having forgotten a lot. That means that I’m in a better position to judge if I have explained everything well.

A tip

  • I find it important to keep creating (writing new content) and correcting (editing existing content) separate. If I try to do both at the same time, I usually end up do neither well.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment