website/docs: new reference template (#6527)

* new reference template

* typos

* tweak

---------

Co-authored-by: Tana Berry <tana@goauthentik.io>
This commit is contained in:
Tana M Berry 2023-08-14 13:51:56 -05:00 committed by GitHub
parent 3040294e17
commit 51e570ec5a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 32 additions and 0 deletions

View File

@ -0,0 +1,31 @@
---
title: "Reference topic"
---
Create a title that specifies the component you are documenting. For example, "Group attributes".
Reference documentation provides details, values, syntax, etc., about specific programming elements.
The most common type of reference documentation is for REST APIs; the request syntax, a successful response, any parameters such as query, header, or request body parameters, and possible http status codes.
Other types of reference content include lists of functions, parameters, event actions, and attributes.
## Overview
Provide a sentence or two about the topic.
## Head 2
Use a title that is descriptive, such as "User object attributes" or "Expression policy functions".
Use tables, bullet lists, Head3s... whatever you need to clearly present the values.
Be sure to use a sentence after every heading, to explain what the section is about, how the values are used, etc.
## Head 3 (optional, if needed)
Add a sentence explaining the following grouping.
## Head 3 (optional, if needed)
Add a sentence explaining the following grouping.

View File

@ -72,6 +72,7 @@ module.exports = {
items: [ items: [
"docs/templates/procedural", "docs/templates/procedural",
"docs/templates/conceptual", "docs/templates/conceptual",
"docs/templates/reference",
], ],
}, },
], ],