Communities

Writing
Writing
Codidact Meta
Codidact Meta
The Great Outdoors
The Great Outdoors
Photography & Video
Photography & Video
Scientific Speculation
Scientific Speculation
Cooking
Cooking
Electrical Engineering
Electrical Engineering
Judaism
Judaism
Languages & Linguistics
Languages & Linguistics
Software Development
Software Development
Mathematics
Mathematics
Christianity
Christianity
Code Golf
Code Golf
Music
Music
Physics
Physics
Linux Systems
Linux Systems
Power Users
Power Users
Tabletop RPGs
Tabletop RPGs
Community Proposals
Community Proposals
tag:snake search within a tag
answers:0 unanswered questions
user:xxxx search by author id
score:0.5 posts with 0.5+ score
"snake oil" exact phrase
votes:4 posts with 4+ votes
created:<1w created < 1 week ago
post_type:xxxx type of post
Search help
Notifications
Mark all as read See all your notifications »
Q&A

Post History

71%
+3 −0
Q&A Does DRY (Don't Repeat Yourself) Apply to Documentation?

In programming, it's usually accepted that DRY code is better code in most situations. Does this principle also apply to documentation? I'm asking about the documentation output, not necessarily ...

3 answers  ·  posted 7y ago by Scribblemacher‭  ·  last activity 3y ago by Lundin‭

#4: Post edited by user avatar Monica Cellio‭ · 2021-02-08T14:38:04Z (over 3 years ago)
  • In programming, it's usually accepted that [DRY code](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself) is better code in most situations.
  • **Does this principle also apply to documentation?**
  • I'm asking about the documentation _output_, not necessarily the source material (there are tools for keeping the source content DRY even if there's a lot of repeated content).
  • Example: suppose I have the following content:
  • - Some task
  • - Prerequisite setup task
  • - How to do X
  • - How to do Y
  • Should "How to do X" and "How to do Y" explicitly say "Before doing this, make sure to do _Prerequisite setup task_"? What are some good rules to follow when deciding if documentation should repeat itself?
  • I intended this question to be about end-user documentation. In some context, such as code or compliance documentation, the answer may drastically change. [See Chenmunka's answer](https://techcomm.stackexchange.com/a/212/271) for some of those implications.
  • In programming, it's usually accepted that [DRY code](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself) is better code in most situations.
  • **Does this principle also apply to documentation?**
  • I'm asking about the documentation _output_, not necessarily the source material (there are tools for keeping the source content DRY even if there's a lot of repeated content).
  • Example: suppose I have the following content:
  • - Some task
  • - Prerequisite setup task
  • - How to do X
  • - How to do Y
  • Should "How to do X" and "How to do Y" explicitly say "Before doing this, make sure to do _Prerequisite setup task_"? What are some good rules to follow when deciding if documentation should repeat itself?
  • I intended this question to be about end-user documentation. In some context, such as code or compliance documentation, the answer may drastically change. [See Chenmunka's answer](https://techcomm.stackexchange.com/a/212/271) for some of those implications.
#3: Attribution notice added by user avatar System‭ · 2019-12-08T08:03:23Z (almost 5 years ago)
Source: https://writers.stackexchange.com/q/33529
License name: CC BY-SA 3.0
License URL: https://creativecommons.org/licenses/by-sa/3.0/
#2: Initial revision by user avatar Scribblemacher‭ · 2019-12-08T08:03:23Z (almost 5 years ago)
In programming, it's usually accepted that [DRY code](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself) is better code in most situations.

**Does this principle also apply to documentation?**

I'm asking about the documentation _output_, not necessarily the source material (there are tools for keeping the source content DRY even if there's a lot of repeated content).

Example: suppose I have the following content:

- Some task
  - Prerequisite setup task
  - How to do X
  - How to do Y

Should "How to do X" and "How to do Y" explicitly say "Before doing this, make sure to do _Prerequisite setup task_"? What are some good rules to follow when deciding if documentation should repeat itself?

I intended this question to be about end-user documentation. In some context, such as code or compliance documentation, the answer may drastically change. [See Chenmunka's answer](https://techcomm.stackexchange.com/a/212/271) for some of those implications.

#1: Imported from external source by user avatar System‭ · 2018-01-31T15:34:03Z (almost 7 years ago)
Original score: 14