diff --git a/src/content/docs/style-guide/documentation-content-strategy/content-types/overview.mdx b/src/content/docs/style-guide/documentation-content-strategy/content-types/overview.mdx index 60b9ddb38e27116..cd6768da0400531 100644 --- a/src/content/docs/style-guide/documentation-content-strategy/content-types/overview.mdx +++ b/src/content/docs/style-guide/documentation-content-strategy/content-types/overview.mdx @@ -99,17 +99,17 @@ Description of external resource related to current product. ## Additional Information -Overiew pages are the default "first" page in any nested navigation. In some cases to ensure good information architecture and navigability, you may need to rename or remove Overview pages. +Overview pages are the default "first" page in any nested navigation. In some cases, to ensure good information architecture and navigability, you may need to rename or remove overview pages. -### When to consider removing an Overview page +### When to consider removing an verview page -If the overview acts as a table of contents that provides no additional information or context, this is when to consider removing it altogether. +If the overview acts as a table of contents that provides no additional information or context, consider removing it altogether. -### How to remove an Overview page +### How to remove an overview page -Deleting the `index.mdx` file of an overview page is not possible and will result in a build error. To remove the page from the docs, the index.mdx file will need to be hidden from displaying through sidebar styling changes. To ensure that users do not accidentally access the overview page, a redirect will need to be added as well. +Deleting the `index.mdx` file in a nested folder is not possible and will result in a build error. To remove the page from the docs, the `index.mdx` file must be hidden using sidebar styling changes. Also, to ensure that users do not accidentally access the overview page, add a redirect. -To hide an overview page, set the group.hideIndex property to true in the page's front matter. +To hide an overview page, set the `group.hideIndex` property to `true` in the page's frontmatter. ``` ---