Documenting is challenging. If you're new to crafting documentation, you may be asking questions like:
A concept page explains complicated concepts simply by providing an overview of a particular topic, including relevant contextual information. These pages focus on the why not the how, and answer questions like these:
A task page provides instructions for completing a piece of work by providing a simple, straightforward description of how to do a particular task. These pages focus on the how not the why, and answer questions like these:
Task pages should not repeat content from concept pages or resemble guided walkthroughs in tutorials. Instead, the main purpose of a task page is to help the reader get something done. Create a task page when you need to document:
A tutorial helps the reader learn a new skill or technique by walking them through an example, step-by-step. Tutorials briefly explain how concepts work together without being a repeat of a conceptual page or as straightforward as a task page. Below are a couple examples of use cases that a tutorial could address:
Life is too short to develop yet another Data API.