update changelog entries

Author: devalog

fern/products/docs/pages/changelog/2025-11-02.mdx

@@ -1,46 +1,33 @@
 ## Navbar dropdown menus
 
-Organize multiple related links in your navbar with dropdown menus. This new navbar link type allows you to group resources, tools, or external links under a single dropdown button, keeping your header clean while providing easy access to multiple destinations.
+Group related links in your navbar with new dropdown menus. Organize resources, tools, or external links under a single button to keep your header clean.
 
 ```yaml title="docs.yml"
 navbar-links:
   - type: dropdown
-    text: Resources
-    icon: fa-solid fa-seedling
+    text: Resources  # dropdown button text
+    icon: fa-solid fa-seedling  # optional icon
     links:
-      - text: Plant database
-        href: https://example.com/plants
-        icon: fa-regular fa-leaf
+      - text: Plant database  # link display text
+        href: https://example.com/plants  # destination URL
+        icon: fa-regular fa-leaf  # optional icon
       - text: Growing guides
         href: https://example.com/guides
-        icon: fa-regular fa-book
-      - text: Community forum
-        href: https://example.com/forum
-        icon: fa-regular fa-comments
 ```
 
-Each dropdown link supports:
-- **text**: The display text for the link
-- **href**: The destination URL
-- **icon**: Optional Font Awesome icon or custom image that displays to the left of the text
-- **rightIcon**: Optional icon that displays to the right of the text
-- **rounded**: Optional boolean to apply fully rounded borders
-
-Learn more in the [navbar links configuration](/learn/docs/configuration/what-is-docs-yml#navbar-links-configuration) documentation.
+Learn more in the [navbar links configuration documentation](/learn/docs/configuration/what-is-docs-yml#navbar-links-configuration).
 
 ## API Explorer direct requests
 
-Bypass the Fern proxy and send API Explorer requests directly to your API with the new `disable-explorer-proxy` setting. This is useful when you want to test your API's CORS configuration or need direct communication between the documentation site and your API.
+You can now send API Explorer requests directly to your API instead of through Fern's proxy. This is useful for testing Cross-Origin Resource Sharing (CORS) configuration and debugging authentication flows.
 
 ```yaml title="docs.yml"
 settings:
   disable-explorer-proxy: true
 ```
 
 <Warning>
-When this feature is enabled, your API must have Cross-Origin Resource Sharing (CORS) enabled to allow requests from the documentation domain.
+Your API must have CORS enabled to allow requests from the documentation domain.
 </Warning>
 
-By default, API Explorer requests are proxied through Fern's servers to avoid CORS issues. With this setting enabled, requests go directly from the user's browser to your API, which can be helpful for testing CORS policies or debugging authentication flows.
-
-Learn more in the [docs.yml reference](/learn/docs/configuration/what-is-docs-yml#settings-configuration) documentation.
+Learn more in the [docs.yml reference documentation](/learn/docs/configuration/what-is-docs-yml#settingsdisable-explorer-proxy).

fern/products/docs/pages/changelog/2025-11-03.mdx

@@ -1,44 +1,23 @@
-## Custom icons for navbar links and navigation
+## Custom icons across your navigation
 
-Add visual interest and improve navigation clarity with custom icons throughout your documentation site. You can now add icons to navbar buttons, dropdown menu items, sidebar sections, and pages.
+You can now use your own image files as icons throughout your `docs.yml` navigation config, including for [navbar link](/learn/docs/configuration/what-is-docs-yml#navbar-links-configuration), [section, page](/learn/docs/configuration/navigation#sidebar-icons), and [product](/learn/docs/configuration/products#add-your-product-configuration) icons.
 
-Icons support three formats:
+Icons now support three formats:
 - **Font Awesome icons**: Use icon names like `fa-solid fa-seedling` or `fa-regular fa-leaf`. Pro and Brand icons from Font Awesome are supported.
-- **Custom image files**: Use relative paths to image files (e.g., `./assets/icons/plant-icon.svg`). Paths are relative to the `docs.yml` file.
+- **Custom image files**: Use relative paths to custom image files (e.g., `./assets/icons/plant-icon.svg`). Paths are relative to the `docs.yml` file.
 - **Inline SVG**: Provide an SVG string wrapped in quotes.
 
-### Navbar link icons
-
-Add icons to navbar buttons and dropdown menu items:
-
-```yaml title="docs.yml"
-navbar-links:
-  - type: minimal
-    text: Plant catalog
-    href: https://example.com/plants
-    icon: fa-solid fa-seedling
-  - type: filled
-    text: Get started
-    href: https://example.com/start
-    icon: ./assets/icons/leaf.svg
-    rightIcon: fa-solid fa-arrow-right
-```
-
-### Sidebar navigation icons
-
-Add icons to sections and pages in your sidebar:
-
-```yaml title="docs.yml"
+```yaml Sidebar icons in docs.yml
 navigation:
-  - section: Plant care
-    icon: fa-solid fa-seedling
+  - section: Home
+    icon: fa-regular fa-home  # Font Awesome icon
     contents:
-      - page: Watering guide
-        icon: fa-solid fa-droplet
-        path: ./pages/watering.mdx
-      - page: Sunlight requirements
-        icon: ./assets/icons/sun.svg
-        path: ./pages/sunlight.mdx
+      - page: Introduction
+        icon: ./assets/icons/intro-icon.svg  # Custom image file
+        path: ./pages/intro.mdx
+      - page: Custom Features
+        icon: "<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='currentColor'><path d='M12 2L2 7v10c0 5.55 3.84 10.74 9 12 5.16-1.26 9-6.45 9-12V7l-10-5z'/></svg>"  # Inline SVG
+        path: ./pages/custom.mdx
+  - api: API Reference
+    icon: fa-regular fa-puzzle
 ```
-
-Learn more in the [navigation configuration](/learn/docs/configuration/navigation#sidebar-icons) and [navbar links configuration](/learn/docs/configuration/what-is-docs-yml#navbar-links-configuration) documentation.