Conceptual content helps people understand a feature or topic by providing a clear, high-level overview, explanation of how the feature or topic can help them on their journey, and context like use cases or examples.
We create conceptual articles and conceptual sections within other articles. Most major products, features, or subjects have their own conceptual article.
For the conceptual content template, see "Templates."
- Describe in plain language what the feature, product, or topic is.
- Describe its purpose and why it’s useful to the reader.
- Share use cases or examples.
- If relevant, describe how the feature or topic works (be mindful of audience and the right location for deep dives into technical details).
- Highlight any details the reader needs to know to use the feature.
- Include next steps for getting started with the feature (whether through further reading links or content within the article itself).
- Conceptual articles or headers of conceptual sections start with "About [subject]”.
- Use a noun to describe the subject.
- Use: "About code scanning"
- Avoid: "About scanning your code for vulnerabilities"