structure

Author: kodster28

src/content/docs/style-guide/api-content-strategy/index.mdx

@@ -1,18 +1,17 @@
 ---
 pcx_content_type: concept
-title: API content strategy
+title: API docs content strategy
 sidebar:
   order: 5
-
 ---
 
-import { DirectoryListing } from "~/components"
+import { DirectoryListing } from "~/components";
 
-The API content strategy aims to:
+The API docs content strategy aims to:
 
-* Reduce internal and external user frustration
-* Align with industry standards in terms of naming conventions and descriptions
-* Create world-class content that is just as good, or better, than very popular API documentation
+- Reduce internal and external user frustration
+- Align with industry standards in terms of naming conventions and descriptions
+- Create world-class content that is just as good, or better, than very popular API documentation
 
 By ensuring Cloudflare's API content is straightforward, easy to navigate, and consistent, we can create world-class API content that eliminates user frustration and serves as an example of good API documentation.
 

src/content/docs/style-guide/documentation-content-strategy/index.mdx

@@ -1,27 +1,26 @@
 ---
 pcx_content_type: concept
-title: Developer documentation content strategy
+title: Product docs content strategy
 sidebar:
   order: 3
-
 ---
 
-import { DirectoryListing } from "~/components"
+import { DirectoryListing } from "~/components";
 
 The purpose of Cloudflare's developer documentation content strategy is to:
 
-* Create and document standard templates to streamline content creation
-* Document specific content types to help identify customers' specific needs
-* Enable life cycle management to maintain and optimize a smaller set of pages
-* Suggest easier navigation paths
+- Create and document standard templates to streamline content creation
+- Document specific content types to help identify customers' specific needs
+- Enable life cycle management to maintain and optimize a smaller set of pages
+- Suggest easier navigation paths
 
 Strategically speaking, the mission and guiding principles translate into the following initiatives:
 
-* Improve the entire ecosystem of customer-facing product content, placing major emphasis on consistency, quality, accuracy, and timeliness
-* Create a cohesive and compelling story around our products and their functionality
-* Develop content that increases product adoption, deflects support, and makes customers successful
-* Partner with various internal departments and stakeholders in creating and sustaining a rich, consistent content experience across all Cloudflare products
-* Devise new and better ways to give users the information they need, when and where they need it
+- Improve the entire ecosystem of customer-facing product content, placing major emphasis on consistency, quality, accuracy, and timeliness
+- Create a cohesive and compelling story around our products and their functionality
+- Develop content that increases product adoption, deflects support, and makes customers successful
+- Partner with various internal departments and stakeholders in creating and sustaining a rich, consistent content experience across all Cloudflare products
+- Devise new and better ways to give users the information they need, when and where they need it
 
 Adoption of this content strategy will be impacted by product releases, resourcing, and company goals.
 
@@ -33,13 +32,13 @@ This approach includes:
 
 ### Information architecture
 
-* Where content should live on the site
-* Linking strategy
+- Where content should live on the site
+- Linking strategy
 
 ### Content
 
-* What content is included and what is optional
-* How the content is written
+- What content is included and what is optional
+- How the content is written
 
 ## Content requirements
 

src/content/docs/style-guide/how-we-docs/image-maintenance.mdx

@@ -0,0 +1,6 @@
+---
+pcx_content_type: how-to
+title: Image maintenance
+meta:
+  title: Image maintenance | How we docs
+---

src/content/docs/style-guide/how-we-docs/index.mdx

@@ -0,0 +1,19 @@
+---
+pcx_content_type: navigation
+title: How we docs
+sidebar:
+  order: 10
+---
+
+import { DirectoryListing } from "~/components";
+
+This section shares how Cloudflare approaches docs strategically, covering topics like `how we built our site` and `how we think about redirects`.
+
+The goal is twofold, because it:
+
+- Encourages deep thinking about how we approach things (and if they could be better).
+- Contributes back to the open-source ecosystem. We get a lot of benefits from being open source and we want to give back.
+
+We hope you learn from the topics below. As always, [submit an issue](https://github.com/cloudflare/cloudflare-docs/issues/new) if you find something inaccurate or unclear.
+
+<DirectoryListing />

src/content/docs/style-guide/how-we-docs/links.mdx

@@ -0,0 +1,6 @@
+---
+pcx_content_type: how-to
+title: Links
+meta:
+  title: Links | How we docs
+---

src/content/docs/style-guide/how-we-docs/metadata.mdx

@@ -0,0 +1,6 @@
+---
+pcx_content_type: how-to
+title: Metadata
+meta:
+  title: Metadata | How we docs
+---

src/content/docs/style-guide/how-we-docs/redirects.mdx

@@ -0,0 +1,6 @@
+---
+pcx_content_type: how-to
+title: Redirects
+meta:
+  title: Redirects | How we docs
+---