1.1 The pit of success

{tidymodels} aims to help us fall into the Pit of Success:

The Pit of Success: in stark contrast to a summit, a peak, or a journey across a desert to find victory through many trials and surprises, we want our customers to simply fall into winning practices by using our platform and frameworks.

  • Avoid confusion: Software should facilitate proper usage.
  • Avoid mistakes: Software should make it easy for users to do the right thing.

Examples of creating a pit of success (discussed in more details later)

  • internal consistency
  • sensible defaults
  • fail with meaningful error messages rather than silently producing incorrect results