add content for managing page visibility

Author: ethanpalm

api-playground/customization/managing-page-visibility.mdx

@@ -0,0 +1,86 @@
+---
+title: "Managing page visibility"
+description: "Control which endpoints from your OpenAPI specification appear in your documentation navigation"
+---
+
+
+You can control exactly which parts of your OpenAPI specification get published and how they're organized. Hiding pages can be useful when you're documenting internal APIs, beta features, or other endpoints that shouldn't appear in navigation.
+
+If your pages are autogenerated from an OpenAPI document, you can control which endpoints get published and how they appear in your documentation with the `x-hidden` and `x-excluded` properties.
+
+## `x-hidden`
+
+The `x-hidden` property creates a page for an endpoint, but hides it from navigation. The page is only accessible by navigating directly its URL.
+
+Common use cases for `x-hidden` are:
+
+- Endpoints you want to document, but not promote.
+- Pages that you will link to from other content.
+- Endpoints for specific users.
+
+## `x-excluded`
+
+
+The `x-excluded` property completely excludes an endpoint from your documentation.
+
+Common use cases for `x-excluded` are:
+
+- Internal-only endpoints.
+- Deprecated endpoints that you don't want to document.
+- Beta features that are not ready for public documentation.
+
+## Implementation 
+
+Add the `x-hidden` or `x-excluded` property under the HTTP method in your OpenAPI specification.
+
+Here are examples of how to use each property in an OpenAPI schema document for an endpoint and a webhook path:
+
+```json {11, 19}
+"paths": {
+  "/plants": {
+    "get": {
+      "description": "Returns all plants from the store",
+      "parameters": { ... },
+      "responses": { ... }
+    }
+  },
+  "/hidden_plants": {
+    "get": {
+      "x-hidden": true,
+      "description": "Returns all somewhat secret plants from the store",
+      "parameters": { ... },
+      "responses": { ... }
+    }
+  },
+  "/secret_plants": {
+    "get": {
+      "x-excluded": true,
+      "description": "Returns all top secret plants from the store (do not publish this endpoint!)",
+      "parameters": { ... },
+      "responses": { ... }
+    }
+  }
+},
+```
+
+```json {9, 15}
+"webhooks": {
+  "/plants_hook": {
+    "post": {
+      "description": "Webhook for information about a new plant added to the store",
+    }
+  },
+  "/hidden_plants_hook": {
+    "post": {
+      "x-hidden": true,
+      "description": "Webhook for somewhat secret information about a new plant added to the store"
+    }
+  },
+  "/secret_plants_hook": {
+    "post": {
+      "x-excluded": true,
+      "description": "Webhook for top secret information about a new plant added to the store (do not publish this endpoint!)"
+    }
+  }
+}
+```