Convert component-library headings and titles to sentence case (#1405)

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: Devin Logan <[email protected]>

Author: devin-ai-integration[bot]

.vale.ini

@@ -19,6 +19,9 @@ Microsoft.Accessibility = NO
 Microsoft.Passive = NO
 Microsoft.Suspended = NO
 Microsoft.Vocab = NO
+Microsoft.Semicolon = NO # Mostly just picks up code
+Microsoft.SentenceLength = NO # Mostly just picks up code
+Microsoft.Dashes = NO
 
 # Not relevant for Fern audience
 Microsoft.GeneralURL = NO

.vale/styles/FernStyles/Headings.yml

@@ -39,4 +39,44 @@ exceptions:
   - gRPC
   - RPC
   - SDK
-  - SDKs
+  - SDKs
+  - Accordion
+  - Accordions
+  - Accordion Groups
+  - Aside
+  - Badge
+  - Badges
+  - Button
+  - Callout
+  - Callouts
+  - Card
+  - Cards
+  - Card Groups
+  - Code Blocks
+  - CodeBlock
+  - CodeBlocks
+  - CodeGroup
+  - Embed
+  - Endpoint Request Snippet
+  - Endpoint Response Snippet
+  - Endpoint Schema Snippet
+  - Frame
+  - Frames
+  - Icon
+  - Icons
+  - Param Field
+  - Param Fields
+  - ParamField
+  - Runnable Endpoint
+  - Step
+  - Steps
+  - Sticky Table
+  - StickyTable
+  - Tab
+  - Tabs
+  - Tooltip
+  - Tooltips
+  - PDF
+  - CSS
+  - HTML
+  - JSON

fern/products/docs/pages/component-library/custom-components/conditional-rendering.mdx

@@ -1,5 +1,5 @@
 ---
-title: Conditionally Rendered Content
+title: Conditionally rendered content
 ---
 
 You can conditionally render content based on the instance or version of the docs, in addition to the role of an authenticated user.
@@ -46,4 +46,4 @@ instances:
 <If viewer={["admin"]}>
   This is an admin feature. It should only be available when the user is an admin.
 </If>
-```
+```

fern/products/docs/pages/component-library/custom-components/custom-css-js.mdx

@@ -139,7 +139,7 @@ You can use custom CSS to create brand-specific styling for tables, components,
 
 ## Custom JavaScript
 
-Customize the behavior of your Docs site by injecting custom JavaScript globally. Add a `custom.js` file and include it in your `fern/` project:
+Customize the behavior of your Docs site by injecting custom JavaScript globally.Add a `custom.js` file and include it in your `fern/` project:
 
 <CodeBlock title="Add the custom.js file">
 ```bash {5}
@@ -266,8 +266,8 @@ ReactDOM.render(
 - `ReactDOM.render()` may need to be called multiple times to prevent it from unmounting (this side-effect will be removed in the future).
 - `yarn build` or `npm build` must generate files with deterministic names to be referenced in `docs.yml`. The above example uses a [`vite` config](https://github.com/fern-api/docs-custom-js-example/blob/main/custom-app/vite.config.ts) to accomplish this.
 - For your hosted Docs site, you may need to update your CD steps to include building the react-app.
-- Custom components are not supported in local development. They are supported in preview links.
+- Custom components aren't supported in local development, but are supported in preview links.
 
 <Info>
 This approach is subject to change, with notice, as we make improvements to the plugin architecture.
-</Info> 
+</Info>    

fern/products/docs/pages/component-library/default-components/accordion-groups.mdx

@@ -6,7 +6,7 @@ description: 'Display expandable/collapsible options that reveal more informatio
 Accordion Groups allow you to organize content into collapsible sections, making it easier for users to navigate through information. With recent updates, our Accordion component now supports improved search functionality using the browser's built-in search feature.
 
 <AccordionGroup>
-  <Accordion title="Basic Usage">
+  <Accordion title="Basic usage">
     Accordion Groups can contain multiple Accordion items. Each item has a title and content that can be expanded or collapsed.
 
     ```jsx
@@ -21,7 +21,7 @@ Accordion Groups allow you to organize content into collapsible sections, making
     ```
   </Accordion>
 
-  <Accordion title="Searchable Content">
+  <Accordion title="Searchable content">
     The updated Accordion component now uses HTML5 `<details>` and `<summary>` elements, enabling browser search (Cmd+F / Ctrl+F) to find content within collapsed sections.
   </Accordion>
 
@@ -30,22 +30,22 @@ Accordion Groups allow you to organize content into collapsible sections, making
   </Accordion>
 </AccordionGroup>
 
-### Enhanced Search Functionality
+### Enhanced search functionality
 
 The recent update to our Accordion component improves content discoverability by allowing users to search through all content, including collapsed sections, using the browser's search function (Cmd+F / Ctrl+F).
 
-### Usage Examples
+### Usage examples
 
 Here are some examples of how to use the Accordion Group component:
 
 <Tabs>
 <Tab title="Example">
   <AccordionGroup>
-    <Accordion title="Simple Text Content">
+    <Accordion title="Simple text content">
       This is a basic example with text content.
     </Accordion>
 
-    <Accordion title="With Code Snippets">
+    <Accordion title="With code snippets">
       You can include code snippets within Accordions:
 
       ```javascript
@@ -55,7 +55,7 @@ Here are some examples of how to use the Accordion Group component:
       ```
     </Accordion>
 
-    <Accordion title="Nested Components">
+    <Accordion title="Nested components">
       Accordions can contain other components:
 
       <Frame caption="Sample image">
@@ -65,14 +65,14 @@ Here are some examples of how to use the Accordion Group component:
   </AccordionGroup>
 </Tab>
 <Tab title="Markdown">
-  <CodeBlock title="Example Usage">
+  <CodeBlock title="Example usage">
     ````jsx
     <AccordionGroup>
-      <Accordion title="Text Example">
+      <Accordion title="Text example">
         This is a basic example of an accordion group.
       </Accordion>
 
-      <Accordion title="Multimedia Example">
+      <Accordion title="Multimedia example">
         You can embed photos, videos, and other media within accordions for rich interactive content.
 
         <embed 
@@ -83,7 +83,7 @@ Here are some examples of how to use the Accordion Group component:
         />
       </Accordion>
 
-      <Accordion title="Rich Content Support">
+      <Accordion title="Rich content support">
         Accordions can contain rich content including code blocks, callouts, and other components.
 
         ```ts
@@ -93,7 +93,7 @@ Here are some examples of how to use the Accordion Group component:
         ```
       </Accordion>
 
-      <Accordion title="Best Practices Using Accordion Groups">
+      <Accordion title="Best practices using Accordion Groups">
         - Use accordion groups when you have multiple related sections
         - Each accordion should have a clear title
         - Keep content concise and focused

fern/products/docs/pages/component-library/default-components/code-blocks.mdx

@@ -272,13 +272,13 @@ By default, long lines that exceed the width of the code block become scrollable
 
 <Tabs>
   <Tab title="Example">
-    ```txt title="Without Word Wrap"
+    ```txt title="Without wordWrap"
     A very very very long line of text that may cause the code block to overflow and scroll as a result. 
     ```
   </Tab>
   <Tab title="Markdown">
     ````markdown
-    ```txt title="Without Word Wrap"
+    ```txt title="Without wordWrap"
     A very very very long line of text that may cause the code block to overflow and scroll as a result. 
     ```
     ````
@@ -289,14 +289,14 @@ To disable scrolling and wrap overflow onto the next line, use the `wordWrap` pr
 
 <Tabs>
   <Tab title="Example">
-    ```txt title="With Word Wrap" wordWrap
+    ```txt title="With wordWrap" wordWrap
     A very very very long line of text that may cause the code block to overflow and scroll as a result. 
     ```
   </Tab>
   <Tab title="Markdown">
     ````markdown
-    ```txt title="With Word Wrap" wordWrap
-    A very very very long line of text that may cause the codeblock to overflow and scroll as a result. 
+    ```txt title="With wordWrap" wordWrap
+    A very very very long line of text that may cause the code block to overflow and scroll as a result. 
     ```
     ````
   </Tab>

fern/products/docs/pages/component-library/default-components/embed.mdx

@@ -28,7 +28,7 @@ Fern also implements a custom component for embedding downloadable assets:
 
 ## Examples
 
-### Video File
+### Video file
 
 <Tabs>
   <Tab title="Example using `<embed>`">
@@ -57,15 +57,15 @@ Fern also implements a custom component for embedding downloadable assets:
   </Tab>
 </Tabs>
 
-### PDF Document
+### PDF document
 
 <embed src="./all-about-ferns.pdf" type="application/pdf" width="100%" height="500px" />
 
 ```jsx
 <embed src="./all-about-ferns.pdf" type="application/pdf" width="100%" height="500px" />
 ```
 
-## Common MIME Types
+## Common MIME types
 
 | File Type  | MIME Type         |
 | ---------- | ----------------- |
@@ -81,7 +81,7 @@ Fern also implements a custom component for embedding downloadable assets:
   video files, consider using MP4 format for maximum compatibility.
 </Note>
 
-## Downloadable Assets
+## Downloadable assets
 
 Enable users to download assets from within your documentation, instead of linking to them, by using the `<Download>` component.
 

fern/products/docs/pages/component-library/default-components/icons.mdx

@@ -36,7 +36,7 @@ Add Font Awesome icons to your docs with customizable styles, colors and sizes u
   Size in 0.25rem increments (e.g., 4 = 1rem)
 </ParamField>
 
-## Font Awesome Styles
+## Font Awesome styles
 
 You can use any Font Awesome style by using either:
 - Short syntax: `icon="heart"` (defaults to solid)
@@ -69,7 +69,7 @@ You can use any Font Awesome style by using either:
   </Tab>
 </Tabs>
 
-## Best Practices
+## Best practices
 
 - Use icons consistently throughout your documentation
 - Keep icon sizes appropriate for their context (16-24px for inline, larger for featured items)

fern/products/docs/pages/component-library/default-components/overview.mdx

@@ -1,5 +1,5 @@
 ---
-title: 'Components Overview'
+title: 'Components overview'
 description: 'Enhance your docs with our built-in component library. Use components to create interactive and engaging documentation.'
 ---
 

fern/products/docs/pages/component-library/writing-content/markdown.mdx

@@ -5,7 +5,7 @@ description: Use Markdown and MDX to add content to your Fern documentation site
 
 ## Add Markdown or MDX pages
 
-Add pages manually to your documentation by creating Markdown (`.md`) or MDX (`.mdx`) files. New to Markdown? See [Markdown Guide: Getting started](https://www.markdownguide.org/getting-started/). 
+Add pages manually to your documentation by creating Markdown (`.md`) or MDX (`.mdx`) files.New to Markdown? See [Markdown Guide: Getting started](https://www.markdownguide.org/getting-started/). 
 
 <Note>
 NOTE: Throughout our documentation, we refer to both Markdown and MDX as Markdown. [MDX](https://mdxjs.com/) is a version of Markdown, extended to allow the use of JSX components.
@@ -247,4 +247,4 @@ erDiagram
     CUSTOMER ||--o{ PLANT-ORDER : places
     PLANT-ORDER ||--|{ PLANT-ID : contains
     CUSTOMER }|..|{ DELIVERY-ADDRESS : uses
-```
+```