Post History
The more your documentation is aimed at people reading it like a book the less you should repeat yourself. The more your documentation is a look at this one page read it put it away the more you sh...
Answer
#3: Attribution notice added
Source: https://writers.stackexchange.com/a/33531 License name: CC BY-SA 3.0 License URL: https://creativecommons.org/licenses/by-sa/3.0/
#2: Initial revision
The more your documentation is aimed at people reading it like a book the less you should repeat yourself. The more your documentation is a _look at this one page read it put it away_ the more you should repeat yourself. The most concrete example I can think of are aviation emergency checklists. No Co-Pilot is ever required to look anywhere else after he opened the correct check list. Everything is on that one page. Even if it's a step that is on half the pages (think _inform tower_), if it's deemed important enough to be there it's on every check list. Since you apparently use automated documentation I'd say few repetitions in the _user training guide_ but repeat yourself a lot in the _emergency recovery runbook._