docs: add descriptions to items in manifest (#18064)

EdwardAngert · matifali · web-flow · commit a6e2d2db992f · 2025-06-04T17:05:01.000Z
[preview](https://coder.com/docs/@manifest-descriptions/admin/users/quotas#up-next) --------- Co-authored-by: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com> Co-authored-by: Atif Ali <atif@coder.com>
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -304,14 +304,17 @@
 							"children": [
 								{
 									"title": "Up to 1,000 Users",
+									"description": "Hardware specifications and architecture guidance for Coder deployments that support up to 1,000 users",
 									"path": "./admin/infrastructure/validated-architectures/1k-users.md"
 								},
 								{
 									"title": "Up to 2,000 Users",
+									"description": "Hardware specifications and architecture guidance for Coder deployments that support up to 2,000 users",
 									"path": "./admin/infrastructure/validated-architectures/2k-users.md"
 								},
 								{
 									"title": "Up to 3,000 Users",
+									"description": "Enterprise-scale architecture recommendations for Coder deployments that support up to 3,000 users",
 									"path": "./admin/infrastructure/validated-architectures/3k-users.md"
 								}
 							]
@@ -341,42 +344,51 @@
 					"children": [
 						{
 							"title": "OIDC Authentication",
+							"description": "Configure OpenID Connect authentication with identity providers like Okta or Active Directory",
 							"path": "./admin/users/oidc-auth.md"
 						},
 						{
 							"title": "GitHub Authentication",
+							"description": "Set up authentication through GitHub OAuth to enable secure user login and sign-up",
 							"path": "./admin/users/github-auth.md"
 						},
 						{
 							"title": "Password Authentication",
+							"description": "Manage username/password authentication settings and user password reset workflows",
 							"path": "./admin/users/password-auth.md"
 						},
 						{
 							"title": "Headless Authentication",
+							"description": "Create and manage headless service accounts for automated systems and API integrations",
 							"path": "./admin/users/headless-auth.md"
 						},
 						{
 							"title": "Groups \u0026 Roles",
+							"description": "Manage access control with user groups and role-based permissions for Coder resources",
 							"path": "./admin/users/groups-roles.md",
 							"state": ["premium"]
 						},
 						{
 							"title": "IdP Sync",
+							"description": "Synchronize user groups, roles, and organizations from your identity provider to Coder",
 							"path": "./admin/users/idp-sync.md",
 							"state": ["premium"]
 						},
 						{
 							"title": "Organizations",
+							"description": "Segment and isolate resources by creating separate organizations for different teams or projects",
 							"path": "./admin/users/organizations.md",
 							"state": ["premium"]
 						},
 						{
 							"title": "Quotas",
+							"description": "Control resource usage by implementing workspace budgets and credit-based cost management",
 							"path": "./admin/users/quotas.md",
 							"state": ["premium"]
 						},
 						{
 							"title": "Sessions \u0026 API Tokens",
+							"description": "Manage authentication tokens for API access and configure session duration policies",
 							"path": "./admin/users/sessions-tokens.md"
 						}
 					]

Original file line number	Diff line number	Diff line change
`@@ -304,14 +304,17 @@`
`304`	`304`	`"children": [`
`305`	`305`	`{`
`306`	`306`	`"title": "Up to 1,000 Users",`
	`307`	`+ "description": "Hardware specifications and architecture guidance for Coder deployments that support up to 1,000 users",`
`307`	`308`	`"path": "./admin/infrastructure/validated-architectures/1k-users.md"`
`308`	`309`	`},`
`309`	`310`	`{`
`310`	`311`	`"title": "Up to 2,000 Users",`
	`312`	`+ "description": "Hardware specifications and architecture guidance for Coder deployments that support up to 2,000 users",`
`311`	`313`	`"path": "./admin/infrastructure/validated-architectures/2k-users.md"`
`312`	`314`	`},`
`313`	`315`	`{`
`314`	`316`	`"title": "Up to 3,000 Users",`
	`317`	`+ "description": "Enterprise-scale architecture recommendations for Coder deployments that support up to 3,000 users",`
`315`	`318`	`"path": "./admin/infrastructure/validated-architectures/3k-users.md"`
`316`	`319`	`}`
`317`	`320`	`]`
`@@ -341,42 +344,51 @@`
`341`	`344`	`"children": [`
`342`	`345`	`{`
`343`	`346`	`"title": "OIDC Authentication",`
	`347`	`+ "description": "Configure OpenID Connect authentication with identity providers like Okta or Active Directory",`
`344`	`348`	`"path": "./admin/users/oidc-auth.md"`
`345`	`349`	`},`
`346`	`350`	`{`
`347`	`351`	`"title": "GitHub Authentication",`
	`352`	`+ "description": "Set up authentication through GitHub OAuth to enable secure user login and sign-up",`
`348`	`353`	`"path": "./admin/users/github-auth.md"`
`349`	`354`	`},`
`350`	`355`	`{`
`351`	`356`	`"title": "Password Authentication",`
	`357`	`+ "description": "Manage username/password authentication settings and user password reset workflows",`
`352`	`358`	`"path": "./admin/users/password-auth.md"`
`353`	`359`	`},`
`354`	`360`	`{`
`355`	`361`	`"title": "Headless Authentication",`
	`362`	`+ "description": "Create and manage headless service accounts for automated systems and API integrations",`
`356`	`363`	`"path": "./admin/users/headless-auth.md"`
`357`	`364`	`},`
`358`	`365`	`{`
`359`	`366`	`"title": "Groups \u0026 Roles",`
	`367`	`+ "description": "Manage access control with user groups and role-based permissions for Coder resources",`
`360`	`368`	`"path": "./admin/users/groups-roles.md",`
`361`	`369`	`"state": ["premium"]`
`362`	`370`	`},`
`363`	`371`	`{`
`364`	`372`	`"title": "IdP Sync",`
	`373`	`+ "description": "Synchronize user groups, roles, and organizations from your identity provider to Coder",`
`365`	`374`	`"path": "./admin/users/idp-sync.md",`
`366`	`375`	`"state": ["premium"]`
`367`	`376`	`},`
`368`	`377`	`{`
`369`	`378`	`"title": "Organizations",`
	`379`	`+ "description": "Segment and isolate resources by creating separate organizations for different teams or projects",`
`370`	`380`	`"path": "./admin/users/organizations.md",`
`371`	`381`	`"state": ["premium"]`
`372`	`382`	`},`
`373`	`383`	`{`
`374`	`384`	`"title": "Quotas",`
	`385`	`+ "description": "Control resource usage by implementing workspace budgets and credit-based cost management",`
`375`	`386`	`"path": "./admin/users/quotas.md",`
`376`	`387`	`"state": ["premium"]`
`377`	`388`	`},`
`378`	`389`	`{`
`379`	`390`	`"title": "Sessions \u0026 API Tokens",`
	`391`	`+ "description": "Manage authentication tokens for API access and configure session duration policies",`
`380`	`392`	`"path": "./admin/users/sessions-tokens.md"`
`381`	`393`	`}`
`382`	`394`	`]`