Skip to content

Refine the AI toolkits landing pages#1670

Merged
sequba merged 1 commit into
developfrom
feature/refinement-of-ai-toolkits-landing-pages
May 11, 2026
Merged

Refine the AI toolkits landing pages#1670
sequba merged 1 commit into
developfrom
feature/refinement-of-ai-toolkits-landing-pages

Conversation

@sequba
Copy link
Copy Markdown
Contributor

@sequba sequba commented May 11, 2026

Summary

Refines the three AI-integration landing pages — Vercel AI SDK, LangChain/LangGraph, and MCP — so they share a single consistent voice, structure, and call to action, and so it is unmistakable that none of these integrations are installable yet.
Resolves HF-53.

Why

Before this change the three pages drifted in three different directions:

  • Only the AI SDK page warned readers that nothing was available yet — the LangChain and MCP pages read like a shipped product.
  • Page depth varied wildly (the LangChain and MCP pages were ~50 lines and missing both safety and links sections; the AI SDK page was much richer).
  • The LangChain page used a Python code example, even though HyperFormula is a TypeScript/JS-only library — misleading for readers.
  • "What it does" and "Use cases" were framed differently on each page (action-shaped vs. domain-shaped vs. host-shaped), hiding the fact that all three integrations expose the same capabilities to an agent.
  • The CTA varied between "Join the waitlist", "Sign up for beta access", and "Drop your email", with no consistent framing of the value of signing up.

What changed

Shared page template (applied to all three pages)

Every page now follows the same section order:

  1. Title + one-line tagline
  2. "Not available yet — coming soon" warning admonition (identical wording on all three pages, with bolded "cannot be installed or used today")
  3. ## What it does — 4 capability bullets (identical wording on all three pages)
  4. ## Example — one short, idiomatic JS/TS example
  5. ## Use cases — 5 jobs-to-be-done bullets (identical on AI SDK and LangChain; MCP gets one extra leading bullet — see below)
  6. ## Get early access — identical CTA admonition framing sign-up as both value to the user (try it before the public release) and value to us (signals demand and shapes priorities)
  7. ## Links — uniform list

"What it does" — now identical across all three pages

  • "Evaluate formulas deterministically"
  • "Read and write cells and ranges"
  • "Trace dependencies"
  • "400+ built-in functions out of the box" (newly surfaced — previously buried inside one LangChain use case despite being HF's biggest differentiator)

"Use cases" — now nearly identical across all three pages

Shared 5-bullet list (Spreadsheet Q&A, what-if and forecasting, validate and clean data, formulas from natural language, financial modeling and reporting).

Per-page specifics

  • docs/guide/ai-sdk.md — kept as the strongest of the three; warning + CTA + section names harmonized; "Planned for the beta" → "Planned for the first release".
  • docs/guide/integration-with-langchain.md — full rewrite: removed the misleading Python example, added a LangGraph createReactAgent JS example mirroring the AI SDK one, added Safety/Links sections.
  • docs/guide/mcp-server.md — full rewrite: replaced the prose-style chat snippet with a concrete npx -y @hyperformula/mcp + client-config example, added Safety/Links sections, swapped "Beta access" CTA for the standardized "Get early access" admonition.

Minor drive-by

  • docs/guide/types-of-values.md — dropped a stray excel language tag on a fenced code block that VitePress does not recognize.

Note

Low Risk
Low risk documentation-only update that rewrites/aligns three integration guides and tweaks one code fence; no runtime or API behavior changes.

Overview
Refactors the ai-sdk, LangChain/LangGraph, and MCP server guide pages to a consistent structure and voice, explicitly stating the integrations are not yet available and pointing readers to a unified early-access signup CTA.

Updates each page’s capability and use-case messaging to match, replaces the LangChain example with an idiomatic JS/LangGraph snippet, and expands the MCP page with concrete npx run + client config examples plus a standardized Links section.

Separately, fixes a docs formatting issue in types-of-values.md by removing an unsupported excel code-fence language tag.

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

@netlify
Copy link
Copy Markdown

netlify Bot commented May 11, 2026

Deploy Preview for hyperformula-docs ready!

Name Link
🔨 Latest commit a759bb4
🔍 Latest deploy log https://app.netlify.com/projects/hyperformula-docs/deploys/6a01d29e5c5d6000086b0b60
😎 Deploy Preview https://deploy-preview-1670--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.

@qunabu
Copy link
Copy Markdown

qunabu commented May 11, 2026

@sequba sequba requested a review from GreenFlux May 11, 2026 12:59
@sequba sequba merged commit 1b6767f into develop May 11, 2026
35 of 36 checks passed
@sequba sequba deleted the feature/refinement-of-ai-toolkits-landing-pages branch May 11, 2026 13:09
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 11, 2026

Performance comparison of head (a759bb4) vs base (24121f8)

                                     testName |   base |   head |  change
-------------------------------------------------------------------------
                                      Sheet A |  487.9 | 493.27 |  +1.10%
                                      Sheet B | 157.25 | 160.18 |  +1.86%
                                      Sheet T | 141.24 | 141.16 |  -0.06%
                                Column ranges | 529.27 | 533.01 |  +0.71%
Sheet A:  change value, add/remove row/column |   15.6 |  18.46 | +18.33%
 Sheet B: change value, add/remove row/column | 136.61 |  163.8 | +19.90%
                   Column ranges - add column | 157.57 | 176.92 | +12.28%
                Column ranges - without batch | 491.52 |  543.5 | +10.58%
                        Column ranges - batch | 129.58 | 140.19 |  +8.19%

@codecov
Copy link
Copy Markdown

codecov Bot commented May 11, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.16%. Comparing base (24121f8) to head (a759bb4).
⚠️ Report is 1 commits behind head on develop.

Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff            @@
##           develop    #1670   +/-   ##
========================================
  Coverage    97.16%   97.16%           
========================================
  Files          175      175           
  Lines        15319    15319           
  Branches      3287     3287           
========================================
  Hits         14884    14884           
  Misses         435      435           
🚀 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.

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.

2 participants