small fixes

Author: devalog

fern/products/docs/pages/api-references/customize-api-ref.mdx

@@ -176,7 +176,7 @@ You can hide an endpoint from the API reference by setting `hidden` to `true`. T
 </Tabs>
 
 ### Adding custom sections
-You can add arbitrary folders in the sidebar by adding a `section` to your API Reference layout. A section can comprise entire groups of endpoints, individual endpoints, or even just Markdown pages. Sections can be customized by adding properties like a `icon`, `summary`, `slug` (or `skip-slug`), and `contents`. 
+You can add arbitrary folders in the sidebar by adding a `section` to your API Reference layout. A section can comprise entire groups of endpoints, individual endpoints, or even just Markdown pages. Sections can be customized by adding properties like a `icon`, `summary`, `slug` (or `skip-slug`), `availability`, and `contents`. 
 
 <Tabs>
   <Tab title="OpenAPI Specification">
@@ -243,18 +243,20 @@ navigation:
 
 ### Adding availability
 
-You can set the availability for the entire API reference or for specific sections.
+You can set the availability for the entire API reference or for specific sections. Options are: `stable`, `generally-available`, `in-development`, `pre-release`, `deprecated`, or `beta`. 
 
-```yaml title="docs.yml" {5}
+
+```yaml title="docs.yml" {3, 6}
 navigation: 
   - api: API Reference
+    availability: generally-available
     layout: 
-      - user: 
-        availability: generally-available
-          - POST /user
-          - PUT /user/{username}
-          - DELETE /user/{username}
-  ```
-When you set availability for an API Reference section, all child endpoints will inherit that availability unless explicitly overridden in your API definition.
+      - section: My Section
+        availability: beta
+        icon: flower
+        contents: 
+```
+
+When you set availability for a section, all endpoints in that section will inherit the section-level availability unless explicitly overridden in your API definition.
 
 <Warning>You can't set availability for individual endpoints in `docs.yml`. Endpoint availability must be configured directly in your API definition. Learn more about availability for [OpenAPI](/learn/api-definitions/openapi/extensions/availability) or [Fern Definition](/learn/api-definitions/ferndef/availability).</Warning>

fern/products/docs/pages/navigation/versions.mdx

@@ -121,7 +121,7 @@ versions:
 ```
 </CodeBlock>
 
-Version availability is distinct from [section and page availability](/learn/docs/configuration/navigation#section-and-page-availability). If you want to set section and page availability, do so in your version-specific `yml` files.
+Version availability is distinct from [section and page availability](/learn/docs/configuration/navigation#section-and-page-availability), with different options. If you want to set section and page availability, do so in your version-specific `yml` files.
 
 </Step>
 <Step title="Remove extra navigation from docs.yml">