Skip to content

docs(seo): cross-link docs pages to www how-to guides and fix footer privacy link - #262

Draft
nicolasiscoding wants to merge 2 commits into
developfrom
seo/docs-www-crosslinks
Draft

nicolasiscoding wants to merge 2 commits into
developfrom
seo/docs-www-crosslinks

Conversation

@nicolasiscoding

@nicolasiscoding nicolasiscoding commented Oct 24, 2026 •

Copy link
Copy Markdown
Member

What changed and why

The docs site and www.turbodocx.com now link to each other. www pages can send readers and authority to the docs, and the docs can send readers to the shorter how-to guides on www.

  • 20 docs pages get a short :::info Learn more admonition near the top. Each one links to the matching how-to guide under www.turbodocx.com/resources. For the three mapped URLs that point at a section anchor (signing order, image variables, Wrike reminders/voids), I put the admonition at the top of that section, not the top of the page, on purpose. The anchor text is the H1 of each www page, taken from TurboDocx/DotCom#425. One exception: the Signature-Setups-on-Templates box says "How to Save a Signature Setup on a Template" instead of the www H1 ("...on a Word or PowerPoint Template"). The docs page says setups also work for PDF templates, so the shorter text avoids contradicting the sentence right above the box. (Reviewer change; the DotCom#425 H1 may want the same fix.)
  • Footer fix: "Privacy Policy" pointed to the Terms of Service URL. It now points to https://www.turbodocx.com/termsofservice/privacy-policy, which returns 200 and is titled "Privacy Policy". That is also the URL the www footer uses (components/Footer.tsx on DotCom staging).
  • Docs home (Welcome page):
    • Under "Get documents signed", a link to the free signature maker (/tools/digital-signature-maker). TurboDocx/DotCom#419 makes that the single owner URL for the signature-tool cluster.
    • Under "Build on the API and SDKs", a link to the developer guides index (/guides).

All www links are plain URLs with no UTM parameters, matching the existing in-body www links in the docs.

Merge order

Merge this after TurboDocx/DotCom#425 is live in production. That PR ships the www how-to pages. When I checked today (2026-10-24), 19 of the 20 counterparts return 404:

Status www URL
200 /resources/bulk-signature-sending-guide
404 /resources/how-to-add-conditional-fields-to-a-signature-document
404 /resources/how-to-set-signing-order
404 /resources/how-to-enable-embedded-signing
404 /resources/how-to-set-up-one-time-passcodes-for-signers
404 /resources/how-to-choose-a-verification-method-for-each-signer
404 /resources/how-to-customize-signature-appearance
404 /resources/how-to-set-up-e-signature-webhooks
404 /resources/how-to-save-a-signature-setup-on-a-template
404 /resources/how-to-create-a-docx-template-with-variables
404 /resources/how-to-use-ai-variables-in-a-template
404 /resources/how-to-add-images-with-an-image-variable
404 /resources/how-to-build-a-table-from-wrike-sub-items
404 /resources/how-to-configure-quote-numbering
404 /resources/how-to-import-products-into-turboquote
404 /resources/how-to-set-up-a-sharepoint-signature-pipeline
404 /resources/how-to-send-a-document-for-signature-from-salesforce
404 /resources/how-to-remind-and-void-signature-requests-from-wrike
404 /resources/how-to-connect-hubspot-to-turbodocx
404 /resources/how-to-connect-connectwise-psa-to-turbodocx

The footer and home-page targets (/termsofservice/privacy-policy, /tools/digital-signature-maker, /guides) are live today and return 200.

Ticket checklist (Docs#256)

  • Add a "Learn more" link at the top of each docs page that has a DC-7 how-to counterpart. All 20 are done.
  • Fix the footer Privacy Policy link.
  • Link the docs home to the free signature tool and the guides index.
  • Acceptance, other direction: I checked the DotCom#425 diff, and each of its 20 pages links to the docs URL in the mapping. Nothing is missing.
Docs page www counterpart
TurboSign/Conditional-Fields how-to-add-conditional-fields-to-a-signature-document
TurboSign/Bulk-Signature-Sending bulk-signature-sending-guide
TurboSign/Setting-up-TurboSign#setting-signing-order how-to-set-signing-order
TurboSign/how-to-enable-embedded-signing how-to-enable-embedded-signing
TurboSign/how-to-configure-one-time-passcode how-to-set-up-one-time-passcodes-for-signers
TurboSign/identity-verification how-to-choose-a-verification-method-for-each-signer
TurboSign/How-to-Configure-Signature-Appearance how-to-customize-signature-appearance
TurboSign/Webhooks how-to-set-up-e-signature-webhooks
TurboSign/Signature-Setups-on-Templates how-to-save-a-signature-setup-on-a-template
TurboDocx-Templating/How-to-Create-a-Template how-to-create-a-docx-template-with-variables
TurboDocx-Templating/ai-variable-generation how-to-use-ai-variables-in-a-template
TurboDocx-Templating/Additional-Information#image how-to-add-images-with-an-image-variable
Integrations/Wrike/table-variable how-to-build-a-table-from-wrike-sub-items
TurboQuote/How-to-Configure-Quote-Numbering how-to-configure-quote-numbering
TurboQuote/Bulk-Importing-from-a-Spreadsheet how-to-import-products-into-turboquote
Pipelines/Creating-an-E-Signature-Pipeline how-to-set-up-a-sharepoint-signature-pipeline
Integrations/turbosign-for-salesforce/send-and-sign how-to-send-a-document-for-signature-from-salesforce
Integrations/Wrike/signature-automation#reminders-re-sends-and-voiding-optional how-to-remind-and-void-signature-requests-from-wrike
Integrations/Hubspot how-to-connect-hubspot-to-turbodocx
Integrations/ConnectWise-PSA how-to-connect-connectwise-psa-to-turbodocx

Overlap with open PRs

Several open PRs edit the same files. I placed each insertion away from their hunks so the merges should be clean:

Whichever PR merges second may still need a trivial rebase.

Verification run

  • Every docs URL in the mapping returns 200 on docs.turbodocx.com.
  • The three section anchors (setting-signing-order, image, reminders-re-sends-and-voiding-optional) exist in the live HTML.
  • I curled each www counterpart (table above), plus the privacy policy, the signature maker and the guides index.
  • footerItems.json parses as valid JSON.
  • No em-dashes in any added line (git diff origin/develop -U0 | grep '^+' | grep — returns nothing). Existing em-dashes in these files are left alone: out of scope, and they would collide with the open PRs.
  • I checked the DotCom#425 diff for links back to docs on all 20 pages.
  • Cloudflare Pages preview build passed (run 40124169732, https://596c3ffb.turbodocx-docs.pages.dev):
    • I curled all 20 changed pages on the preview. Each returns 200 and contains exactly one "Learn more" admonition linking to the expected www URL.
    • Spot checks on four pages, including the one inside a <div> (Setting-up-TurboSign) and the section-level one (Additional-Information): each renders as theme-admonition-info, with no literal ::: text.
    • The docs home renders the signature maker and guides links.
    • The footer "Privacy Policy" link now points to /termsofservice/privacy-policy.

Not verified

  • The www counterparts render correctly. 19 of the 20 are not live yet.
  • A Docusaurus build does not check external links, so a green preview build does not prove the www links resolve.

Owner questions

  • The docs home now links to /tools/digital-signature-maker as "the free signature tool". Should it point to /free-electronic-signature instead? That page is the free plan for signing documents, which is a different offer.

Part of #256
Closes #261

…privacy link

Add a Learn more admonition to 20 docs pages pointing to their
www.turbodocx.com/resources how-to counterpart, link the docs home to
the free signature maker and the developer guides index, and point the
footer Privacy Policy link at /termsofservice/privacy-policy instead of
the Terms of Service URL.
@nicolasiscoding nicolasiscoding added the seo Search engine optimization label Oct 24, 2026
@nicolasiscoding nicolasiscoding self-assigned this Oct 24, 2026
@nicolasiscoding nicolasiscoding added the seo Search engine optimization label Oct 24, 2026
The page says signature setups work for Word, PowerPoint and PDF, so the
link text no longer limits it to Word or PowerPoint.

This branch was successfully deployed

1 active deployment
preview — ab8e2c6e Deployed Oct 24, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

seo Search engine optimization

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(seo): cross-link docs pages to www how-to guides and fix footer privacy link

1 participant