Skip to content

[Trace] Docs playbook fixes: broken link, meta descriptions, thin pages - #182

Merged
nicolasiscoding merged 2 commits into
developfrom
trace/docs-playbook-0927
Sep 27, 2026
Merged

nicolasiscoding merged 2 commits into
developfrom
trace/docs-playbook-0927

Conversation

@nicolasiscoding

@nicolasiscoding nicolasiscoding commented Sep 27, 2026 •

Copy link
Copy Markdown
Member

Closes TurboDocx/DotCom#304
Closes TurboDocx/DotCom#305

Trace AI SEO Playbook full run, 2026-09-27, scanned against Docs main. One PR for all Docs findings from the run.

1. Broken link (broken-link-checker)

  • TurboSign/Webhooks.md: "View Integration Guides" linked /docs/Integrations, which returns 404 (Docs has no integrations index page). It now points to https://www.turbodocx.com/integrations (200).

2. Meta descriptions over 160 chars (meta-length-checker)

  • TurboSign/How to Configure Signature Appearance.md: 231 → 149 (also removes em-dashes)
  • TurboSign/Conditional Fields.md: 206 → 145
  • Pipelines/Pipeline Notifications.md: 179 → 144
  • TurboDocx Templating/Template Troubleshooting.md: 171 → 151

3. Thin pages expanded (thin-content-detector, quality-gates min 300 words)

Page Words before Words after
Welcome to TurboDocx.md 66 673
Advanced Configuration/Single-Sign On.md 243 592
Advanced Configuration/SCIM Provisioning.md 275 713
Integrations/Google Drive.md 208 665

Facts were checked against the shipped product:

  • SSO: SAML 2.0/OIDC, Enterprise plan, set up with support. Microsoft Entra ID is proven in production. Auto-linking to existing accounts requires an IdP-verified email.
  • SCIM: SCIM 2.0 users (create, filtered/paginated read, PATCH replace, deactivate), one bearer token per organization.
  • Google Drive: import Docs/.docx (Slides/.pptx when PPTX is enabled), export to a chosen folder, Personal Drive only, plan-gated.

Deliberately not claimed:

  • IdPs other than Entra ID by name; the page says any SAML/OIDC provider can connect.
  • SCIM group sync (not implemented).
  • Enterprise pricing and support SLAs.

Not changed (expected or false positives): auto-generated API/*.api.mdx, Ruby SDK drafts (gem unpublished), npm/Maven/AppSource 403s (bot blocking), commented-out images in ai-variable-generation.md.

Test plan

  • meta-length-checker and thin-content-detector pass for these pages
  • New link target returns 200; no em-dashes; front-matter keys and slugs unchanged
  • Docs build / deploy check

@nicolasiscoding nicolasiscoding self-assigned this Sep 27, 2026
@nicolasiscoding
nicolasiscoding marked this pull request as ready for review September 27, 2026 17:59
@nicolasiscoding
nicolasiscoding merged commit b95b319 into develop Sep 27, 2026
1 check passed

This branch was successfully deployed

1 active deployment
preview — 3c6fb611 Deployed Sep 27, 2026 by github-actions[bot]
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.

1 participant