Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section
show-titlefalse
titleDescription

KISS - Keep It Simple, Stupid: Complex things need to be explained at an appropriate, simple level. Complex things need not to be complicated.

Quote External
authorAlbert Einstein
author-urihttps://en.wikipedia.org/wiki/Albert_Einstein

Everything should be made as simple as possible, but not simpler.

To explain complex things in a simple way, may be a lot of work, though.

Quote External
authorAntoine de Saint-Exupéry
author-urihttps://en.wikipedia.org/wiki/Antoine_de_Saint-Exupéry

It seems that perfection is reached not when there is nothing left to add, but when there is nothing left to take away.

If the tools you employ are not simple enough, but you cannot reduce the quality requirements on your documentation or communication, you need to provide support for your teams. Create the role of a documentation gardener to support team members on their documentation tasks. Allow feedback to flow to the gardener and the information architect to continuously improve the documentation process.

Make work on documentation a first citizen in your project and provide resources for it explicitly. Value the documentation created as much as any other new features for your product.

KISS - Keep It Simple, Stupid

Section
titleExample

Section
titleContext

...

Section
required-permissionswrite-access
titleNotes

Section
titleReferences
intro-textMore information on this principle.
Tour
render-as-definition-listtrue
marker-column-property-nameTitle
replace-title-with-nametrue
TitleShort Description
Keep It SimpleThe principle described as a pattern on wiki.c2.com.
KISS principleThe principle described on Wikipedia.
Section
titleResources