One real key to writing an unruly, hard to organize text is transition sentences. There’s no perfect path through a complex topic, and sometimes no very good path either. Put together an acceptable one and write great transitions.
That’s not my jam. My method is to start with two outlines.
On the right, the outline of the genre (for a science paper, “abstract”, “introduction”, “premises”, “conclusion” etc. For fiction, the events chronologically and escalatingly, with any mysteries pulled out and saved as later reveals. For technical or political texts, and I need to get better at this, start with the new discovery or main point, and then follow up with the how and why).
On the left, my own mindmap of everything I found out—mindmaps can be converted to outlines. Then move everything over one by one and then write it clean.
While this is still good for longer texts, I don’t use this very often anymore for blog-length texts because I often just do it mentally instead. I imagine the underlying tree structure skeleton without having it explicitly written out and then move things around in my head to guide my prose editing.
I use the path through the text as a test for “does this work”. The reader is going to experience the “tree” of ideas as a depth-first tree-walk and if nodes don’t fit together, I need to reorder, move things around, or even remove or add nodes.
If I can’t find a good path without segues, I shelve the text.
This happens around one or two out of five texts. Often they get rescued later. A path will reveal itself, the missing nodes will have shown up, the superfluous nodes will have outstayed their welcome. Other times the idea is dumb and unworkable and I leave it in the shelf. Even then, the story of the idea (“I used to think that…”) is a good addition to a later text.
I edit a lot, even small posts and replies on Fedi and IRC, where rcirc’s multiline buffer (C-c C-c) is a godsend. That’s why I’m so much clumsier when talking in person. (That and the accent.)
There are a lot of patterns to my editing. I’m like “OK, I can remove the parens around this parenthetical, it belongs in the main text” and “I need to move this up” and “OK, this became redundant” or “OK, this entire topic needs to be its own post, and it needs to be published first so I can refer back to it”.
The reason my art is progressing so much slower, and is so much more terrifying, is because I can’t find good feedback. With writing, I could, as long as my writing was in tree parser languages like Lisp and Lojban. The compiler is a harsh mistress. It made me comfortable with writing and refactoring (without fear, since every step of the way I could compile and see if it still worked and tests still ran), and I brought those editing patterns back to English.
When working with trees this way, there’s an important limitation to keep in mind compared to graph trees.
If you start a subsection, you can’t go back to the section you started it from. You can start a new subsubsection, a sibling subsection, or a new section at any higher level, but you can’t resume the section you were in. This used to trip me up all the time when I was writing. I’ve learned that I need to hold off on starting subsections until I’m done with what I wanted to say in the section itself.
The hacky workaround, which I sometimes resort to, is sidebars or footnotes.
highlight-regexp and the other highlight- functions are such
lifesavers when writing prose in Emacs.♥︎ For example, today I was
writing an essay about layers and formats and then I decided to
simplify it and combine the two concepts, and highlighting them both
in different colors was great. I reordered the ideas I was presenting,
so having concepts highlighted helped me find when I first introduced
them and when I referred back to them.
None of this writing-nerd–talk is meant to be gatekeepy. Writing can be simple. You can get 80% of the way there with 20% of the effort. Please don’t think I want to make writing harder for you.
Like all arts, I keep finding new ways to improve and I’m glad that I have a long road ahead of me still, because I enjoy it. That also includes unlearning some bad lessons and misconceptions I picked up along the way. You might have to think of how you got started sitting in your little room.
So draw back your bows, you hunters, who have never felt that flame!