Multiple content updates (#57)

Replaced "Disclosure" with "LinkOut" in example on index page. Removed note about build errors from LinkOut page since the issue is fixed. Overhauled the Markdown syntax page as the info was more general to markdown than it is to the ILF. Added note to the Disclosure page that we should use Details instead, and that the Disclosure page may be going away. Added a Details page. Changed references to running prettier to pnpm format since it's easier to remember. Added a page specifically for Starlight components.

astro.config.mjs

@@ -45,7 +45,7 @@ export default defineConfig({
           },
         },
         {
-          label: "Classes and styles",
+          label: "Classes, styles, HTML",
           autogenerate: {
             directory: "classes",
           },

src/content/docs/classes/details.mdx

@@ -0,0 +1,33 @@
+---
+title: details
+---
+
+The `<details>` disclosure element is an HTML element that creates a disclosure widget in which information is visible only when the widget is toggled into an open state. A `summary` or label must be provided using the `<summary>` element. - [MDN web docs](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details)
+
+:::note
+We also have an in-house [Disclosure component](/shared/disclosure), but we decided in October 2024 to move away from using it. We may deprecate the component completely in the future.
+:::
+
+You can nest any other Markdown syntax inside a `<details>` element. Some, if not all, of Starlight's components can also be nested. For example, you can use an aside within the element.
+
+## Example usage
+
+```html
+<details>
+<summary>Who has two thumbs, speaks limited French, and hasn't cried once today?</summary>
+<img
+  src="/img/thismoi.png"
+  alt="Liz Lemon"
+  style="max-width:200px"
+/>
+</details>
+```
+
+<details>
+<summary>Who has two thumbs, speaks limited French, and hasn't cried once today?</summary>
+<img
+  src="/img/thismoi.png"
+  alt="Liz Lemon"
+  style="max-width:200px"
+/>
+</details>

src/content/docs/content/global.mdx

@@ -53,7 +53,7 @@ Use sentence case for headings, subheadings, and page titles unless a word/term
 
 ### Initialisms
 
-Capitalize each letter in an initialism. For example, WM for Web Monetization.
+Capitalize each letter in an initialism. For example, ASE for account servicing entity.
 
 ### Commas
 
@@ -77,11 +77,11 @@ Typically, partials should be used for small chunks of repeating content. If the
 
 Note:
 
-- Don’t include front matter in your partials file.
+- Don’t include frontmatter in your partials file (e.g., `title`).
 - Headings within a partials file do not appear in a page’s table of contents.
 - Multiple partial files are supported within a single page.
 
-### Embed a partial file
+### Embed a partial
 
 First, import the partial file into the page:
 
@@ -99,13 +99,15 @@ This is a paragraph of text. I want the partial content to appear beneath this p
 <NoPay />
 ```
 
+That's it!
+
 ## Digital wallet vs account
 
 The term _digital wallet_ can be interpreted a number of ways and we want to be as unambiguous as possible. Be aware of the context in which you’re using the term. Think about whether _account_ or _Open Payments-enabled account_ would be more accurate than _digital wallet_.
 
 ## Doc file extensions (MD/MDX)
 
-Create new doc files in MDX unless there’s a need for something else.
+Create new doc files in MDX unless you have a good reason not to.
 
 ## Example URLs, including wallet addresses
 
@@ -126,7 +128,7 @@ Reference: https://en.wikipedia.org/wiki/Example.com
 
 ### Overviews
 
-Starlight automatically sets the first heading on a page to Overview, even if the markdown file has an H1 or H2 defined.
+Starlight automatically sets the first heading on a page to "Overview", even if the markdown file has an H1 or H2 defined.
 
 ## Images
 

src/content/docs/content/interledger.mdx

@@ -4,7 +4,7 @@ title: Interledger (developers) style guide
 
 import { Card } from '@astrojs/starlight/components';
 
-<Card title="After a Starlight upgrade" icon="star">
+<Card title="After a Starlight upgrade to interledger.org-developers" icon="star">
 ```
 cd <to project folder>
 bun install