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.
How to write conceptual content
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).
Titles for conceptual content
- 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"
Examples of conceptual content
- Conceptual articles
- Conceptual sections within other articles
- "About security policies" in Adding a security policy to your repository
- "About maintenance mode" in Enabling and scheduling maintenance mode