Skip to content

How to select a content type

As the Cloudflare docs have grown, we have added content types that can be hard to differentiate from each other. The Cloudflare docs team does not expect customers to know the nuances between these content types, but we define similar content types in specific ways for formatting, maintenance, and analytic tracking reasons.

This page explains the differences between some of the commonly conflated content types.

Should I create a How to, Tutorial, 3rd-party integration guide, or Solution guide?

Content typeDefinition
How toFor users who have already chosen a Cloudflare product. A set of steps to complete a singular task within that product. The tone is instructional and straightforward, tending toward concise steps with little to no additional context in each step.
TutorialFor users who have already chosen a Cloudflare product. A set of steps tailored to a particular goal or use case, and may involve multiple products. The tone is more guiding and may include context or rationale in addition to a concise step.
3rd-party integration guideA set of steps that explains how to connect Cloudflare and a third-party product. The tone is instructional and straightforward, similar to a how to.
Solution guideFor users who arrive with a goal or problem rather than a product name. Identifies which Cloudflare products apply and walks the user through configuring them together. Typically involves multiple Cloudflare products. Lives at Use cases.