Jump to content

Instruction creep

From Meta, a Wikimedia project coordination wiki
This is an archived version of this page, as edited by David Gerard (talk | contribs) at 11:52, 15 November 2004 (shuffle first para). It may differ significantly from the current version.

Instruction creep is when instructions increase in size over time until they are unmanageable. It is an insidious disease, originating from ignorance of the KISS principle and resulting in bloated pages that are harder to maintain. High traffic, interactive pages (e.g. Village pump, Featured article candidates) tend to be most susceptible.

Instruction creep occurs when a well-meaning user thinks "Hrm ... this page would be better if everyone was supposed to do this" and adds more requirements to the instructions.

The fundamental fallacy of instruction creep is thinking that people read instructions. If people read instructions, we wouldn't have the problem the new instruction is meant to solve.

Instructions must be pruned regularly. Gratuitous requirements must be removed as soon as they are added.

Logging and archiving requirements are probably the most common form of instruction creep. Procedural steps are popular to add, but unpopular to follow. In the future, the Mediawiki software may automate some common labour-intensive tasks.

See also

  • Creeping featurism, when a computer program ends up doing more and more.
  • Functionality creep, when a physical document or other non-computer related procedure ends up serving unexpected or unplanned purposes.