Hacker News new | ask | show | jobs
by annnoo 2983 days ago
According to the spiral plan the chapters get written and re-written in the order 1, 2, 1, 2, 3, 1, 2, 3, 4, etc. You think you know how to write Chapter 1, but after you’ve done it and gone on to Chapter 2, you’ll realize that you could have done a better job on Chapter 2 if you had done Chapter 1 differently

I guess this is one of the best tips in terms of general structured writing.

2 comments

Otherwise known as the doctoral advisor method.
Why is that better than the iterative plan, where you write all 5 chapters and then rewrite chapter 1 once to support all 5 chapters?
You write chapter 1. This is math, you've laid out several definitions, theorems, propositions. You write chapters 2-5. You get to 5 and you realize your choice of terms was poor. Or that you only define some term in chapter 5.

You realize that definition should be before chapter 5, but in which chapter? 1, 2, 3, or 4?

You have to review each chapter (probably in reverse order) to determine the latest position it should be in.

Additionally, as you add that definition you find out that there's even more that needs to be shifted. Do you reorganize the whole thing, or leave it as is? You'll end up spending as much time reworking the text as you did writing the original.

===

Really, this is a philosophical thing. In the spiral approach you end up reviewing things early and realizing what's missing and where they should be moved. In your approach, you don't get to do the review until late. Is it wrong? No. But it can create a less flexible document that requires more effort (and not less) to correct.

This is very similar to the argument in lean software development of keeping batch sizes low (small number of changes at a time) but running them more frequently. Versus the waterfall approach which has large batch sizes and takes much longer to do it all, with a big review near the end.