Diataxis

• Guides lead a user through a specific task they want to accomplish, often with a sequence of steps.
  • Writing a good guide requires thinking about what your users are trying to do.
• Reference pages are ideal for outlining how things work in terse and clear terms.
  • Less concerned with telling a story or addressing a specific use case, they should give a comprehensive outline of what you’re documenting.

Further reading

• Read about how-to guides in the Diátaxis framework