Skip to content

Fix tech SEO issues: sitemap cleanup and broken link fixes (DOC-2396)#1035

Merged
bharathk08 merged 3 commits into
devfrom
DOC-2396
Jun 19, 2026
Merged

Fix tech SEO issues: sitemap cleanup and broken link fixes (DOC-2396)#1035
bharathk08 merged 3 commits into
devfrom
DOC-2396

Conversation

@bharathk08

@bharathk08 bharathk08 commented Jun 19, 2026

Copy link
Copy Markdown
Contributor
  • Remove 56 dead/redirect URLs from sitemap.xml (30x301, 26x404)
  • Fix 12 broken internal links across 11 docs files
  • Update terminal install links in copilot FAQs to testsigma-terminal/ paths
  • Replace dead genai-capabilities/ links with current atto/ equivalents
  • Fix relative .md links in test-data files to absolute paths
  • Update features-and-scenarios URL to correct create-test-cases/ path

Summary by CodeRabbit

  • Documentation

    • Updated internal documentation links and paths for improved consistency across test data, auto-healing, copilot, and generative AI sections.
    • Separated Web and Mobile Web platform entries in the generative AI capabilities list.
    • Refined documentation references to point to the latest resource locations.
  • Chores

    • Updated project configuration files.

- Remove 56 dead/redirect URLs from sitemap.xml (30x301, 26x404)
- Fix 12 broken internal links across 11 docs files
- Update terminal install links in copilot FAQs to testsigma-terminal/ paths
- Replace dead genai-capabilities/ links with current atto/ equivalents
- Fix relative .md links in test-data files to absolute paths
- Update features-and-scenarios URL to correct create-test-cases/ path

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@bharathk08 bharathk08 requested a review from Abdul-jailani June 19, 2026 05:21
@coderabbitai

coderabbitai Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@bharathk08, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 26 minutes and 37 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 7656fc3d-1c70-43a7-adef-e018e4554d74

📥 Commits

Reviewing files that changed from the base of the PR and between 6fa035d and 540b0ae.

📒 Files selected for processing (1)
  • src/pages/docs/sitemap.xml
📝 Walkthrough

Walkthrough

Multiple documentation pages are updated to replace relative markdown hyperlinks with absolute /docs/... URL paths across test data profile, test case, copilot, auto-healing, and generative AI sections. The generative AI overview splits a combined web/mobile link and updates the Figma integration route. The sitemap is refreshed with new URL blocks and updated lastmod timestamps. Two entries are added to .gitignore.

Changes

Documentation Link Fixes, Sitemap Refresh, and .gitignore

Layer / File(s) Summary
.gitignore additions
.gitignore
Adds .claude-skills/ directory and .DS_Store file to ignore rules.
Test data profile pages: relative to absolute link migration
src/pages/docs/test-data/create-data-profiles.md, src/pages/docs/test-data/folder-structure-for-test-data-profiles.md, src/pages/docs/test-data/add-values-to-test-data-profile.md, src/pages/docs/test-data/import-data-profiles.md, src/pages/docs/test-data/update-test-data-profile.md
Prerequisite and related-article links across all five test data profile pages are changed from relative .md filenames to absolute /docs/test-data/.../ URL paths.
Test case and test step pages: prerequisite link updates
src/pages/docs/test-cases/create-test-cases/test-cases-for-mobile-applications.md, src/pages/docs/test-cases/create-test-cases/test-cases-for-web-applications.md, src/pages/docs/test-cases/create-test-steps/overview.md
"Creating folders" prerequisite links updated in mobile and web test case pages; Features and Scenarios URL updated in test step overview prerequisites.
Copilot and auto-healing page link corrections
src/pages/docs/copilot/faqs-on-copilot.md, src/pages/docs/copilot/introduction.md, src/pages/docs/auto-healing/intro.md
Copilot FAQ's Testsigma Terminal installation links changed from /docs/copilot/ to /docs/testsigma-terminal/ paths; auto-healing intro replaces "Live Editor" bullet with "Copilot Test Execution"; a standalone line is added in the copilot introduction resource list.
Generative AI overview: split web/mobile links and update Figma route
src/pages/docs/atto/generative-ai/overview.md
Combined "Web & Mobile Web" link is split into two separate entries; Figma Designs integration link updated from genai-capabilities/... to atto/generative-ai/integrations/figma/.
Sitemap URL block replacements and lastmod refresh
src/pages/docs/sitemap.xml
Specific <url> blocks removed and replaced throughout the sitemap; <lastmod> timestamps updated from 2025-01-23 to 2026-01-21 for the later segment of entries.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

  • testsigmahq/testsigma-docs#892: Directly modifies src/pages/docs/atto/generative-ai/overview.md by changing hyperlinks in the "Generate Tests from Generative AI" section, the same file and section changed in this PR.
  • testsigmahq/testsigma-docs#968: Overlaps with this PR's test data profile link migrations across add-values-to-test-data-profile.md, create-data-profiles.md, folder-structure-for-test-data-profiles.md, import-data-profiles.md, and update-test-data-profile.md.
  • testsigmahq/testsigma-docs#839: Also modifies src/pages/docs/auto-healing/intro.md by changing internal links and bullet entries on the same page.

Suggested labels

bug

Suggested reviewers

  • Nandhini4501
  • Abdul-jailani
  • Santhosh-testsigma

Poem

🐇 Hopping through the docs with care,
Old broken links now fresh as air!
Absolute paths from end to end,
Sitemap timestamps round the bend.
.DS_Store banished far away —
A tidy warren saves the day! 🌿

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main changes: fixing technical SEO issues through sitemap cleanup and correcting broken links, which aligns with all major changes across the changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch DOC-2396

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
src/pages/docs/copilot/faqs-on-copilot.md (1)

220-222: 💤 Low value

Fix markdown blockquote formatting (extra spaces).

Lines 220–222 have multiple spaces after the blockquote marker >. Remove the extra spaces to match markdown best practices.

🎯 Proposed fix for blockquote spacing
-> -   [Documentation on installing Terminal for macOS](https://testsigma.com/docs/testsigma-terminal/installing-testsigma-terminal/).
-> -   [Documentation on installing Terminal for Windows](https://testsigma.com/docs/testsigma-terminal/installing-testsigma-terminal-on-windows/).
-> -   [Documentation on installing Terminal for Linux](https://testsigma.com/docs/testsigma-terminal/installing-testsigma-terminal-on-linux/).
+> - [Documentation on installing Terminal for macOS](https://testsigma.com/docs/testsigma-terminal/installing-testsigma-terminal/).
+> - [Documentation on installing Terminal for Windows](https://testsigma.com/docs/testsigma-terminal/installing-testsigma-terminal-on-windows/).
+> - [Documentation on installing Terminal for Linux](https://testsigma.com/docs/testsigma-terminal/installing-testsigma-terminal-on-linux/).
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@src/pages/docs/copilot/faqs-on-copilot.md` around lines 220 - 222, The
blockquote formatting on lines 220–222 in the faqs-on-copilot.md file has
multiple spaces after the blockquote marker `>`. Remove the extra spaces between
the `>` character and the list items (the documentation links for Terminal
installation on macOS, Windows, and Linux) so that there is only a single space
after the `>` marker, following markdown best practices.

Source: Linters/SAST tools

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@src/pages/docs/test-data/create-data-profiles.md`:
- Line 51: The link "[Create a Test Data
Profile](/docs/test-data/create-data-profiles/)" at line 76 is self-referential,
pointing to the same page it appears on. Given the context "For more
information, see...", this should be corrected by either replacing it with a
link to a related external page that provides additional guidance (such as a
page explaining how to fill in profile fields), converting it to an anchor link
that points to a specific section within this same page using the format
[text](`#section-anchor`), or removing the link entirely if no additional external
reference is needed. Evaluate the surrounding content and user intent to
determine the most appropriate fix.

---

Nitpick comments:
In `@src/pages/docs/copilot/faqs-on-copilot.md`:
- Around line 220-222: The blockquote formatting on lines 220–222 in the
faqs-on-copilot.md file has multiple spaces after the blockquote marker `>`.
Remove the extra spaces between the `>` character and the list items (the
documentation links for Terminal installation on macOS, Windows, and Linux) so
that there is only a single space after the `>` marker, following markdown best
practices.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 5dd336e9-da3b-4307-8e5c-e89ce6f61478

📥 Commits

Reviewing files that changed from the base of the PR and between 9cda530 and 6fa035d.

📒 Files selected for processing (14)
  • .gitignore
  • src/pages/docs/atto/generative-ai/overview.md
  • src/pages/docs/auto-healing/intro.md
  • src/pages/docs/copilot/faqs-on-copilot.md
  • src/pages/docs/copilot/introduction.md
  • src/pages/docs/sitemap.xml
  • src/pages/docs/test-cases/create-test-cases/test-cases-for-mobile-applications.md
  • src/pages/docs/test-cases/create-test-cases/test-cases-for-web-applications.md
  • src/pages/docs/test-cases/create-test-steps/overview.md
  • src/pages/docs/test-data/add-values-to-test-data-profile.md
  • src/pages/docs/test-data/create-data-profiles.md
  • src/pages/docs/test-data/folder-structure-for-test-data-profiles.md
  • src/pages/docs/test-data/import-data-profiles.md
  • src/pages/docs/test-data/update-test-data-profile.md
💤 Files with no reviewable changes (1)
  • src/pages/docs/sitemap.xml

> Before you begin, ensure that you have:
> 1. An active Testsigma project with the required permissions to manage test data.
> 2. A Feature and Scenario set up in Test Data Profiles. For more information, see [Folder Structure for Test Data Profiles](folder-structure-for-test-data-profiles.md).
> 2. A Feature and Scenario set up in Test Data Profiles. For more information, see [Folder Structure for Test Data Profiles](/docs/test-data/folder-structure-for-test-data-profiles/).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Description: Verify all test-data links point to canonical routes in left-nav-title.json

# Check left-nav-title.json for test-data routes
echo "=== Canonical test-data routes in left-nav-title.json ==="
rg -A 1 'create-data-profiles|folder-structure|add-values|import-data|update-test' src/left-nav-title.json | head -40

# Also verify the file structure exists
echo ""
echo "=== Checking if markdown files exist ==="
fd -t f 'create-data-profiles|folder-structure|add-values|import-data|update-test' src/pages/docs/test-data/

Repository: testsigmahq/testsigma-docs

Length of output: 797


🏁 Script executed:

cat -n src/pages/docs/test-data/create-data-profiles.md | sed -n '45,80p'

Repository: testsigmahq/testsigma-docs

Length of output: 2624


Self-referential link at line 76 should be corrected.

Line 76 contains a link to /docs/test-data/create-data-profiles/ from within the same file. This creates a self-referential link in the "Create a Test Data Profile" section with link text "Create a Test Data Profile". Given the context ("For more information, see...") this is likely unintentional. Consider:

  • Whether this should link to a related page instead (e.g., a guide on filling in profile fields)
  • Using an anchor link to guide users to a specific section within this page
  • Removing the link if no additional context is needed
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@src/pages/docs/test-data/create-data-profiles.md` at line 51, The link
"[Create a Test Data Profile](/docs/test-data/create-data-profiles/)" at line 76
is self-referential, pointing to the same page it appears on. Given the context
"For more information, see...", this should be corrected by either replacing it
with a link to a related external page that provides additional guidance (such
as a page explaining how to fill in profile fields), converting it to an anchor
link that points to a specific section within this same page using the format
[text](`#section-anchor`), or removing the link entirely if no additional external
reference is needed. Evaluate the surrounding content and user intent to
determine the most appropriate fix.

bharathk08 and others added 2 commits June 19, 2026 11:07
…2396)

For each removed 301 redirect entry, ensure the canonical destination URL
is present in the sitemap. Adds 7 missing URLs: live-editor/introduction,
5 testsigma-terminal install pages, and integrations/test-labs/testmu.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
… it)

The live-editor/ directory doesn't exist in this repo — adding this URL
would have introduced another potential redirect chain.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@bharathk08 bharathk08 merged commit db41a35 into dev Jun 19, 2026
3 of 4 checks passed
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.

2 participants