agent docs

Author: mdjastrzebski

agents/build-and-validation.md

@@ -10,13 +10,23 @@
 - Check formatting: `yarn format:check`
 - Validate the main package: `yarn validate`
 - Build the package: `yarn build`
+- Regenerate package docs: `yarn docs:generate`
+- Check package docs are in sync: `yarn docs:check`
 
 ## Command notes
 
 - `yarn lint` runs ESLint on `src`.
 - `yarn validate` runs typecheck, tests, lint, and oxfmt checks for the main package.
 - `yarn build` cleans `dist/`, transpiles source with Babel, and emits TypeScript declarations.
 
+## Documentation
+
+- The docs under `website/docs/` are the source of truth. The `docs/api/*.md` files are
+  generated from them — never edit those by hand.
+- After making any documentation changes, run `yarn docs:generate` to regenerate the package
+  docs, and commit the regenerated files alongside your `website/` edits. `yarn docs:check`
+  (part of `validate:all`) fails if they are out of sync.
+
 ## Repo layout
 
 - `src/`: source code

docs/api/fire-event.md

@@ -166,6 +166,9 @@ await fireEvent.scroll(screen.getByTestId('scroll-view'), eventData);
 
 ### `fireEvent.layout`
 
+> [!NOTE]
+> Available since React Native Testing Library 14.1.0.
+
 ```tsx
 fireEvent.layout: (
   instance: TestInstance,

docs/api/user-event.md

@@ -296,6 +296,9 @@ The sequence of events depends on whether the scroll includes an optional moment
 
 ## `accessibilityAction()`
 
+> [!NOTE]
+> Available since React Native Testing Library 14.1.0.
+
 ```ts
 accessibilityAction(
   instance: TestInstance,