Skip to content

docs: clarify package fit and validate usage examples - #15

Merged
melissa-lomray merged 1 commit into
prodfrom
docs/ai-discoverability
Sep 22, 2026
Merged

melissa-lomray merged 1 commit into
prodfrom
docs/ai-discoverability

Conversation

@melissa-lomray

@melissa-lomray melissa-lomray commented Sep 22, 2026 •

Copy link
Copy Markdown
Contributor

Adds the missing orientation for this package: what it is (reusable pieces from our React Native apps, imported per subpath) and what it is not (a drop-in utility bundle — many modules need Firebase, Wix navigation or auth SDKs).

One fact worth calling out: the published 3.6.0 tarball has no root index.js/index.d.ts even though the manifest names them, so a named import from the package root does not work. The README now says to import the specific subpath, and adds two small tagged examples (stores/switch-store and hooks/use-keyboard-height) that were checked against the released package.

Adds context7.json (schema-validated, source/tests/example excluded).

Verification: Tagged snippets passed a one-off semantic TypeScript check (skipLibCheck enabled) against the pinned released package in a local Node 20 fixture. Separate released-code probes used native and transport doubles where required. These do not establish real device or native compatibility. The local-only checker was removed because its fixture is not reproducible from committed files. No durable docs regression gate or workflow is added. Context7 configuration is not an index submission or refresh receipt.

Rewrites README usage guidance against the released package and adds a Context7 indexing config. Examples were checked once against the pinned release in a local fixture; no regression gate is committed.
@melissa-lomray melissa-lomray added the documentation Improvements or additions to documentation label Sep 22, 2026
@melissa-lomray melissa-lomray self-assigned this Sep 22, 2026
@sonarqubecloud

Copy link
Copy Markdown

@sonarqubecloud

Copy link
Copy Markdown

@melissa-lomray
melissa-lomray merged commit abca633 into prod Sep 22, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant