Skip to content

docs: rewrite AI SDK landing page to model Exa's reference DX - #1667

Closed
GreenFlux wants to merge 1 commit into
developfrom
docs/ai-sdk-realistic
Closed

GreenFlux wants to merge 1 commit into
developfrom
docs/ai-sdk-realistic

Conversation

@GreenFlux

@GreenFlux GreenFlux commented Apr 29, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Restructure docs/guide/ai-sdk.md to follow Exa's developer-reference layout: Install → Setup → Quickstart → Example → Use cases → Safety → All options → TypeScript → Links.
  • Frame the SDK as framework-agnostic with Vercel AI SDK as the headline integration example.
  • Mark the SDK as beta/preview to set expectations against the still-placeholder API surface, and add the Safety and guardrails section called out in the HF-53 brief.

Closes HF-53.

Test plan

  • npm run docs:dev and verify the page renders under Guide → Integrations → HyperFormula AI SDK.
  • Confirm all internal links (built-in functions, custom functions) and external links (HubSpot beta form, GitHub, npm) resolve.
  • Sanity-check that no other guide pages are affected.

Note

Low Risk
Documentation-only changes with no runtime or API behavior modifications; main risk is minor user confusion if previewed APIs/options diverge from implementation.

Overview
Rewrites docs/guide/ai-sdk.md into a more complete landing page with a clear flow (Install → Setup → Quickstart → Example → Use cases → Safety → Options → TS → Links) and positions the AI SDK as beta/preview.

Adds a concrete Vercel AI SDK generateText integration snippet, expands messaging around local/deterministic execution, and introduces a new Safety and guardrails section plus a table of planned createSpreadsheetTools options and TypeScript typing notes.

Reviewed by Cursor Bugbot for commit 810de4b. Bugbot is set up for automated code reviews on this repo. Configure here.

Restructure the AI SDK guide to follow Exa's developer-reference layout
(Install, Setup, Quickstart, Example, Use cases, Safety, Options, Links)
and frame the SDK as framework-agnostic with Vercel AI SDK as the
headline integration example. Mark the SDK as beta to set expectations
against the placeholder API surface, and add a Safety and guardrails
section per the HF-53 brief.
@qunabu

qunabu commented Apr 29, 2026

Copy link
Copy Markdown
Contributor

@netlify

netlify Bot commented Apr 29, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for hyperformula-docs ready!

Name Link
🔨 Latest commit 810de4b
🔍 Latest deploy log https://app.netlify.com/projects/hyperformula-docs/deploys/69f1f98aa5826100082c680e
😎 Deploy Preview https://deploy-preview-1667--hyperformula-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@GreenFlux
GreenFlux requested a review from sequba April 29, 2026 12:33
@github-actions

github-actions Bot commented Apr 29, 2026 •

Copy link
Copy Markdown

Performance comparison of head (810de4b) vs base (8b525cb)

                                     testName |   base |   head | change
------------------------------------------------------------------------
                                      Sheet A | 492.89 | 487.66 | -1.06%
                                      Sheet B | 156.36 | 156.74 | +0.24%
                                      Sheet T | 137.18 |  139.3 | +1.55%
                                Column ranges | 520.34 | 515.05 | -1.02%
Sheet A:  change value, add/remove row/column |  16.16 |     16 | -0.99%
 Sheet B: change value, add/remove row/column | 149.09 | 138.11 | -7.36%
                   Column ranges - add column |  163.5 | 154.06 | -5.77%
                Column ranges - without batch | 487.03 | 469.74 | -3.55%
                        Column ranges - batch | 122.86 | 120.58 | -1.86%

@codecov

codecov Bot commented Apr 29, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.18%. Comparing base (8b525cb) to head (810de4b).

Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff            @@
##           develop    #1667   +/-   ##
========================================
  Coverage    97.18%   97.18%           
========================================
  Files          174      174           
  Lines        15086    15086           
  Branches      3223     3223           
========================================
  Hits         14662    14662           
  Misses         424      424           
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

sequba pushed a commit that referenced this pull request May 11, 2026
…#1669)

## Summary
- Reframe [docs/guide/ai-sdk.md](docs/guide/ai-sdk.md) around a
HyperFormula + Vercel AI SDK integration with a single integrated
`generateText` example as the only code block.
- Mark the SDK as an unreleased prototype via a top-of-page warning
callout, and add a prominent waitlist CTA with the existing HubSpot
form.
- Rename the sidebar entry in
[docs/.vuepress/config.js](docs/.vuepress/config.js) to "Integration
with Vercel AI SDK".

Closes [HF-53](https://app.clickup.com/t/86c7upjar). Supersedes #1667.

## Test plan
- [ ] `npm run docs:dev`, open `/guide/ai-sdk`, confirm sidebar reads
"Integration with Vercel AI SDK" and the prototype callout sits above
the fold.
- [ ] Confirm the Vercel `generateText` snippet is the only code block
and the page no longer carries Install / Setup / All options /
TypeScript sections.
- [ ] Click the waitlist link and external links (Vercel docs, GitHub,
npm); click internal links to built-in / custom functions guides.

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Low Risk**
> Low risk: documentation-only changes (sidebar label and guide content)
with no runtime or API behavior impact.
> 
> **Overview**
> Reframes `docs/guide/ai-sdk.md` as **HyperFormula tools for the Vercel
AI SDK**, adding a top-of-page *prototype/not-yet-released* warning, a
single `generateText`-based example, updated use cases, and a waitlist
CTA plus relevant links.
> 
> Renames the guide’s sidebar entry in `docs/.vuepress/config.js` from
“HyperFormula AI SDK” to **“Integration with Vercel AI SDK”**.
> 
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
3eb3e85. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Co-authored-by: Joseph Petty <greenflux@Josephs-MacBook-Pro.local>
@sequba

sequba commented May 11, 2026

Copy link
Copy Markdown
Contributor

Closing in favor of #1669

@sequba sequba closed this May 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants