Merge pull request #2066 from chanzuckerberg/release-v15.4.1

### [15.4.1](v15.4.0...v15.4.1) (2024-10-04)

[Storybook](https://61313967cde49b003ae2a860-ffjofyjbkx.chromatic.com/)

### Bug Fixes

* **Button:** specify size for enabled/disabled buttons ([#2063](#2063)) ([39f3af6](39f3af6))

Author: booc0mtaco

.storybook/components/Docs/Guidelines/CodeGuidelines.mdx

@@ -6,6 +6,7 @@ import { Canvas, Meta } from '@storybook/blocks';
 
 EDS component code follows these principles and conventions for HTML, CSS, and JavaScript/TypeScript/React:
 
+- [Reading Figma APIs](#figma)
 - [HTML](#html)
 - [CSS](#css)
   - [CSS design principles](#css-design-principles)
@@ -22,6 +23,24 @@ EDS component code follows these principles and conventions for HTML, CSS, and J
 - [Accessibility](#accessibility)
   - [Tools](#accessibility-tools)
 
+# Reading Figma APIs <a name="figma"></a>
+
+Both code and figma component documentation have different needs. Tackling the API is not an exact science, so we include some guidelines on how to read and implement the APIs.
+
+## Exact matching APIs
+
+Cases where the API names match **exactly** between code and figma:
+
+- **boolean fields** (e.g., `isFullWidth`, `hasLeadingIcon`) - match the names of boolean fields between code and figma, to avoid ambiguity and confusion
+
+## Figma APIs not in Code
+
+- By convention, some APIs shown in Figma are for designers and should not be implemented in code. These should include a marker both in the API table and figma component UI (e.g., the gear emoji)
+
+## Code APIs not in Figma
+
+- In code, there will be APIs for handling events, controlling other UI behaviors, and some props needed for React implementations. We annotate these by grouping the APIs in the props in the types either under `// Component API` or `// Design API`.
+
 # HTML principles and conventions <a name="html"></a>
 
 - **Use semantic markup.** That means using the `<button>` tag rather than `<div onClick={toggle}>` when a button is required, an `<a>` tag when a link is required, and so on.