Repository navigation
EXP-4: complete docs Organization and WebSite JSON-LD - #883
warp-agent-staging[bot] wants to merge 6 commits into
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
This PR was generated with Warp. Comment |
|
Autoresearch: EXP-4 is ready for review.
|
|
@warp-agent-staging[bot] I'm starting a first review of this pull request. You can view the conversation on Warp. I completed the review and no human review was requested for this pull request. Comment Powered by Oz |
There was a problem hiding this comment.
Overview
This PR completes the docs homepage Organization and WebSite JSON-LD metadata, removes a dead sameAs identity URL, and extends the homepage JSON-LD test to verify the new structured-data contract.
Concerns
No correctness, security, documentation-quality, or spec-alignment concerns found in the annotated diff. No approved spec context was provided for implementation comparison.
Verdict
Found: 0 critical, 0 important, 0 suggestions
Approve
Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).
Powered by Oz
Owner feedback: Warp should be presented as Warp Factories, consistent with www.warp.dev's H1s. Use the shared Factories-first Organization description (identical to warp-marketing-3#817, same @id) and lead the docs WebSite description with Warp Factories.
|
Positioning update (owner feedback): Warp is presented as Warp Factories. Pushed in bf4c972:
|
|
Tone pass after the docs owner asked for plainer wording: the WebSite description now says "along with cloud agents, the Warp Agent, and the Warp terminal" instead of "Warp agents" (the ambiguous form AGENTS.md rules out). The validator assertion was updated to match. Merged |
Summary
Experiment: EXP-4
Complete the Organization and WebSite JSON-LD descriptions on docs pages and remove the dead Slack invite from Organization sameAs (the orchestrator verified its final destination returns 403). No visible copy or Sanity data changes.
Hypothesis: a factual company description gives answer engines explicit entity context, while the docs WebSite description clarifies its scope. Completing these structured-data fields should satisfy ora's json-ld check without changing navigation or page content.
Metric: ora json-ld check on docs.warp.dev, baseline 2/4; measured 4/4 on public preview; predicted 4/4 on next production scan (canonical baseline 62/C).
Prediction: +~1 canonical ora point within 1 week of merge.
Owner judgment needed on exact Organization wording: “Warp builds an agentic development environment and Warp Factories, open infrastructure for software factories powered by agents.” WebSite wording matches the existing llms.txt summary verbatim.
Related issues
2026-10-09 AEO autoresearch brief; additional identity-link verification from the orchestrator.
Validation
How verified:
npm run test:homepage-json-ldbefore rebuilding failed: description was undefined, proving the regression assertion detects the existing omission.npm run typecheck && npm run test:heading-vars && npm run build && npm run test:heading-tocs && npm run test:homepage-json-ld: passed; 0 type errors, 5 heading tests, 3,353 TOC entries across 396 HTML files, Organization/WebSite descriptions and identity linkage valid.npm run lint/npm run fmt: unavailable (Trunk not installed).git diff --check: passed.curl -fLsS https://docs-git-factory-exp-4-docs-organization-warpdotdev.vercel.app -o preview.html: parsed Organization and WebSite descriptions are present; shared company @id, publisher link and sameAs identities preserved without the dead invite. Company description now matches the canonical wording requested for www docs: Factory Microsoft Teams integration + audit existing integrations #817.npx -y @ora-ai/ax@0.5 audit https://docs.warp.dev --json > prod.json: production canonical 62/C. Preview hostname identity effects lower the raw preview score, so the orchestrator approved Automated SEO fixes: lengthen short API errors title and trim long description #872 as unchanged control.npx -y @ora-ai/ax@0.5 audit https://docs-r7655tvgt-warpdotdev.vercel.app --json > control.jsonandnpx -y @ora-ai/ax@0.5 audit https://docs-git-factory-exp-4-docs-organization-warpdotdev.vercel.app --json > preview.json: control timestamp 2026-10-09T18:15:42.351Z; final preview timestamp 2026-10-09T18:16:05.217+00:00. Compared all 125layers[].checks[]score/status pairs: only json-ld improves, no regressions. No forced scans.G3: all checks green including CodeQL (10 successful, 2 policy-skipped). A false-positive URL-substring CodeQL alert on the array
.includes()assertion was fixed with an exact expected-array assertion; no sanitization behavior exists in the test. PR remains draft, no reviewers requested.Rollback: revert this PR to restore the previous identity JSON-LD; no page URLs or visible content are affected.
Follow-ups
Owner approval of the company description; verify the next production ora scan after merge.