Skip to content

Apply documentation edit pass - #1244

Open
stephenvapiai wants to merge 5 commits into
mainfrom
codex/documentation-edit-pass
Open

stephenvapiai wants to merge 5 commits into
mainfrom
codex/documentation-edit-pass

Conversation

@stephenvapiai

@stephenvapiai stephenvapiai commented Sep 22, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Standardize Function tool response terminology
  • Clarify MCP and API Request tool recommendations
  • Update the legacy Make route to point to the new integration guide
  • Improve the Function tool request JSON example
  • Standardize example domains and phone numbers

Scope

This follow-up applies a focused documentation edit pass after #1243.

It intentionally leaves the Make page title and structure, the MCP client navigation label, fern/tools/mcp.mdx, and generated API schemas unchanged.

Validation

  • Parsed all 3 JSON examples in fern/tools/custom-tools.mdx
  • Parsed all 4 JSON examples in fern/tools/static-variables-and-aliases/static-parameters.mdx
  • Confirmed example values use a reserved example.com domain and +1 415 555-01xx phone numbers
  • Confirmed /tools/make redirects to the existing /tools/integrations/make route
  • Confirmed the MCP client navigation label remains unchanged
  • Ran git diff --check
  • Scanned the changed pages for hidden work material
  • Did not run local Fern checks

@lightsage-app

lightsage-app Bot commented Sep 22, 2026

Copy link
Copy Markdown

Lightsage docs evals

Result: completed with failures
Staging docs: https://vapi-preview-01a0cf22-3e88-7573-9ebf-98313ccc098c.docs.buildwithfern.com
Commit: 588883d

Average score: 67/100
Passed: 2/3
Failed: 1

Eval ID Status Score Model Tools Docs 404
08e24c18-82a0-45de-abdc-d237bd12bc0f Pass 100 claude-code/global.anthropic.claude... 26 0
08e24c18-82a0-45de-abdc-d237bd12bc0f Fail 0 cursor/auto 0 0
08e24c18-82a0-45de-abdc-d237bd12bc0f Pass 100 codex/gpt-5.4 35 2

@github-actions

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

Comment thread fern/tools/integrations/make.mdx Outdated
stephenvapiai and others added 2 commits September 23, 2026 09:12
Co-authored-by: Amanda Martin <290842976+amanda-vapi@users.noreply.github.com>
@github-actions

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

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