TurboDocx / TurboDocx/Docs

Internal broken links (404s) across docs.turbodocx.com — SEO crawl errors

Open
#102 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug
Dominant language
JavaScript
Stars
2
Forks
2
Avg merge
5h 41m
Merged PRs (30d)
5

Description

Summary

Ahrefs Site Audit flags a cluster of internal links on docs.turbodocx.com pointing to pages that 404. These are page slugs/paths that were likely renamed or removed without updating the linking pages or adding redirects. All verified still live as of this report.

Broken internal links (source page → dead target)

Source page Broken link target Verified
/docs/TurboSign/Webhooks /docs/Integrations 404
/docs/TurboSign/API%20Signatures /docs/Integrations 404
/docs/SDKs/java /docs/TurboSign/API-Signatures 404
/docs/SDKs/go /docs/TurboSign/API-Signatures 404
/docs/TurboDocx%20Templating/ai-variable-generation /docs/Integrations 404
/docs/TurboDocx%20Templating/ai-variable-generation /docs/Templates/best-practices 404
/docs/TurboDocx%20Templating/ai-variable-generation /docs/Templates/bulk-generation 404
/docs/TurboDocx%20Templating/ai-variable-generation /docs/Templates/template-management 404
/docs/TurboDocx%20Templating/ai-variable-generation /docs/Webhooks/webhook-configuration 404
/docs/TurboDocx%20Templating/API%20Templates /docs/Integrations 404
/docs/TurboDocx%20Templating/API%20Templates /docs/Templates/bulk-generation 404
/docs/TurboDocx%20Templating/API%20Templates /docs/Templates/template-management 404
/docs/TurboDocx%20Templating/API%20Templates /docs/Templates/version-control 404
/docs/TurboDocx%20Templating/API%20Templates /docs/Webhooks/webhook-configuration 404
/docs/SDKs/partner-javascript (nofollow) /docs/API/partner-api 404
https://docs.turbodocx.com/api (linked from dotcom, see [DotCom issue]) n/a 404 — no /api route exists
https://docs.turbodocx.com/integrations/hubspot (linked from dotcom) n/a 404 — no /integrations/* route exists

/docs/Integrations, /docs/Templates/best-practices, /docs/Templates/bulk-generation, /docs/Templates/template-management, /docs/Templates/version-control, and /docs/Webhooks/webhook-configuration account for most of the fan-out — fixing/redirecting these 6 target paths (or updating the ~9 source pages that link to them) clears the bulk of this list.

Also noted (likely not actionable, lower priority)

Several docs SDK pages (/docs/SDKs/webhooks-ruby, /docs/SDKs/deliverable-ruby, /docs/SDKs/ruby, /docs/SDKs/quote-ruby, /docs/SDKs/java) link out to rubygems.org/gems/turbodocx-sdk and search.maven.org/artifact/com.turbodocx/turbodocx-sdk, both returning 403 to the Ahrefs crawler. These look like bot-blocking on the package registries' side rather than genuinely dead links — worth a manual spot-check in a browser, but likely no action needed.

Suggested fix

  1. For each dead target: either the page was renamed (add a redirect / fix the link to the new slug) or the content never existed (remove/update the link or write the missing page).
  2. Check docs.turbodocx.com/api and docs.turbodocx.com/integrations/hubspot — dotcom links to these paths but no matching docs route exists; coordinate with the DotCom repo fix.

Related: #101 (Font Awesome kit 403 site-wide)

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the documentation routes and the source pages listed in the issue, then verify each dead target and determine whether it was renamed, removed, or never existed. Update the affected links or redirects, check the /api and /integrations/hubspot paths with the DotCom repository, and rerun a link crawl to confirm the listed 404s are resolved.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.