Repository navigation
EXP-4: complete docs Organization and WebSite JSON-LD - #883
warp-agent-staging[bot] wants to merge 4 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:
|
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.