docs: update docs based on recent fern-platform commits (2026-05-20)

fern/products/dashboard/pages/changelog/2026-05-20.mdx

@@ -0,0 +1,13 @@
+---
+tags: ["security"]
+---
+
+## Preview site deletion for all org members
+
+Any organization member can delete preview docs sites from the Dashboard. Deleting production docs sites still requires Admin permissions.
+
+<Button intent="none" outlined rightIcon="arrow-right" href="/learn/dashboard/configuration/permissions">Read the docs</Button>
+
+## AI usage page improvements
+
+The AI usage page in the Dashboard has been redesigned with an improved table layout, animated gauge icon, and a date-range calendar picker for filtering usage data.

fern/products/dashboard/pages/permissions.mdx

@@ -74,9 +74,11 @@ Viewers have read-only access to the Dashboard (settings, analytics) and can dep
 | Manage members                | Yes   | No                   | No     |
 | Add or update a custom domain | Yes   | No                   | No     |
 | Manage password protection    | Yes   | No                   | No     |
+| Delete production docs sites  | Yes   | No                   | No     |
 | View dashboard and analytics  | Yes   | Yes                  | Yes    |
 | Publish to production         | Yes   | Configure per Editor | No     |
 | Deploy previews               | Yes   | Yes                  | Yes    |
+| Delete preview docs sites     | Yes   | Yes                  | Yes    |
 | Generate locally              | Yes   | Yes                  | Yes    |
 | Use Fern Editor               | Yes   | Yes                  | No     |
 

fern/products/docs/pages/api-references/generate-graphql-ref.mdx

@@ -8,6 +8,10 @@ availability: pre-release
 
 Fern generates API Reference documentation from a [GraphQL schema](https://graphql.org/learn/schema/). Add your schema file to your Fern project and Fern renders queries, mutations, subscriptions, and types as an interactive reference.
 
+## Examples and descriptions
+
+When a GraphQL operation has multiple examples, an example selector dropdown appears above the code snippet panel. Each example shows its query, variables, and response. If an example includes a description, it appears in a banner below the code snippet header so readers can understand the purpose of each example without leaving the reference page.
+
 ## Configuration
 
 <Steps>

fern/products/docs/pages/changelog/2026-05-20.mdx

@@ -0,0 +1,17 @@
+---
+tags: ["api-reference", "customization", "bug-fix"]
+---
+
+## GraphQL example selector
+
+GraphQL operations with multiple examples display an example selector dropdown above the code snippet panel. Select an example to view its query, variables, and response. Examples that include a description show it in a banner below the snippet header.
+
+<Button intent="none" outlined rightIcon="arrow-right" href="/learn/docs/api-references/generate-graphql-ref">Read the docs</Button>
+
+## Theme switcher removed from search
+
+The theme switcher that appeared inside the search dialog has been removed. Theme switching remains available through other controls on your docs site.
+
+## Custom icon CORS fix
+
+Custom file icons uploaded for use on docs sites no longer trigger CORS errors when loaded cross-origin. If you previously saw broken icons on a custom domain, they should render correctly without any configuration change.