clean up doc

Author: devalog

fern/assets/styles.css

@@ -1082,7 +1082,8 @@ h1, h2, h3 {
 /*** END -- LANDING PAGE STYLING ***/
 
 /* HACK: add a slash to markdown snippet documentation (otherwise it gets parsed by CLI) */
-.modify-snippet tbody tr:last-of-type td:last-of-type .line span:last-of-type:before {
+.modify-snippet tbody tr:nth-child(1) td:last-of-type .line span:last-of-type:before,
+.modify-snippet tbody tr:nth-child(5) td:last-of-type .line span:last-of-type:before {
   content: "/";
   display: inline-block;
 }

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

@@ -1,11 +1,11 @@
 ## Parameterized markdown snippets
 
-Reusable markdown snippets support arbitrary parameters that can be used as variables in the snippet. This enables flexible, reusable content templates.
+Reusable Markdown snippets support arbitrary parameters that can be used as variables in the snippet. This enables flexible, reusable content templates.
 
 Create a snippet with parameter placeholders using curly braces:
 
 ```mdx fern/snippets/watering-schedule.mdx
-Water your {plant} every {interval} days.
+<Warning>Remember to water your {plant} every {interval} days.</Warning>
 ```
 
 Pass parameters when including the snippet:
@@ -16,8 +16,6 @@ Pass parameters when including the snippet:
 
 This renders as:
 
-```
-Water your peace lily every 3 days.
-```
+<Markdown src="/snippets/watering-schedule.mdx" plant="peace lily" interval="3" />
 
-Learn more about [reusable markdown snippets](/learn/docs/writing-content/reusable-snippets#parameterized-snippets).
+Learn more about [reusable Markdown snippets](/learn/docs/writing-content/reusable-snippet).

fern/products/docs/pages/component-library/custom-components/reusable-markdown.mdx

@@ -27,28 +27,38 @@ fern
 In each snippet file, define the content you want to reuse.
 
 ```mdx title="snippets/peace-lily.mdx"
-<Warning> Remember to water your plant at least twice a week. </Warning>
+Peace lilies are easy to grow and relatively trouble-free.
 ```
+
+Optionally, you can use parameters in your snippet:
+```mdx title="snippets/watering-schedule.mdx"
+<Warning>Remember to water your {plant} every {interval} days.</Warning>
+```
+
 </Step>
 <Step title="Use a snippet">
 
-To use a snippet in your documentation, reference it by its file path (including the `.mdx` extension). For example, to include the `peace-lily` snippet from the folder structure above:
+To use a snippet in your documentation, reference it by its file path (including the `.mdx` extension). If you used one or more parameters in your snippet, pass them in the snippet reference:
 
 <Tabs>
     <Tab title="Markdown">
         <div className="modify-snippet">
         ```jsx
-        Peace lilies are easy to grow and relatively trouble-free.
-
         <Markdown src="/snippets/peace-lily.mdx">
+
+        They symbolize peace and prosperity.
+
+        <Markdown src="/snippets/watering-schedule.mdx" plant="peace lily" interval="3">
         ```
         </div>
 
     </Tab>
     <Tab title="Preview">
-        Peace lilies are easy to grow and relatively trouble-free.
-        
         <Markdown src="/snippets/peace-lily.mdx" />
+
+        They symbolize peace and prosperity.
+
+        <Markdown src="/snippets/watering-schedule.mdx" plant="peace lily" interval="3" />
     </Tab>
 </Tabs>
 
@@ -62,38 +72,5 @@ To use a snippet in your documentation, reference it by its file path (including
     | `fern/docs/guides/snippets/peace-lily.mdx` | `src="/docs/guides/snippets/peace-lily.mdx"` |
 </Note>
 </Step>
-<Step title="Parameterized snippets">
-
-Reusable markdown snippets support parameters that you pass as props to the Markdown component. Reference them inside the snippet with `{paramName}`.
-
-Create a snippet with parameter placeholders:
-
-```mdx title="snippets/watering-schedule.mdx"
-Water your {plant} every {interval} days.
-```
 
-Pass parameters when including the snippet:
-
-<Tabs>
-    <Tab title="Markdown">
-        ```jsx
-        <Markdown src="/snippets/watering-schedule.mdx" plant="peace lily" interval="3" />
-        ```
-    </Tab>
-    <Tab title="Preview">
-        <Markdown src="/snippets/watering-schedule.mdx" plant="peace lily" interval="3" />
-    </Tab>
-</Tabs>
-
-You can use multiple parameters in a single snippet:
-
-```mdx title="snippets/plant-care.mdx"
-The {plant} thrives in {light} light and prefers {temperature} temperatures.
-```
-
-```jsx
-<Markdown src="/snippets/plant-care.mdx" plant="fern" light="indirect" temperature="moderate" />
-```
-
-</Step>
 </Steps>

fern/snippets/peace-lily.mdx

@@ -1 +1 @@
-<Warning> Remember to water your plant at least twice a week. </Warning>
+Peace lilies are easy to grow and relatively trouble-free.

fern/snippets/plant-care.mdx

@@ -1 +1 @@
-Water your {plant} every {interval} days.
+<Warning>Remember to water your {plant} every {interval} days.</Warning>