KOB-51832 Removed pages and made redirects

[tiffany-kobiton]

Summary

Unpublished the Figma integration docs (entire directory) and Validations using Antora’s underscore convention and added redirects to the Integrations index. Content is preserved in git and can be restored easily if needed. Removed and redirected Validate UI design page which mentioned Figma.

Related PRs, issues, or features (optional)

Metadata

• Adds new file(s)
• [ ✅ ] Edits existing file(s)
• [ ✅ ] Removes file(s)

PR contributor checklist

• [✅ ] My PR follows the Kobiton Docs contributor guidelines, meaning:

  • My content contains correct spelling and grammar.
  • My directories and files are named and structured correctly.
  • My style and voice follows the Microsoft Style Guide.
  • I added all new pages to their section's nav.adoc file.
  • I removed all localizations (like en-us) from my URLs.

Summary by CodeRabbit

• Documentation
  • Removed Figma integration documentation entries from the integrations module navigation.
  • Reorganized test management documentation by removing the validation subsection and introducing new remediation subsection links.
  • Updated session explorer validation documentation with improved navigation structure.
  • Added page aliases to documentation indexes for improved navigation routing.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

Documentation navigation links for Figma integration and validation features are removed from navigation files while corresponding page aliases are added to index files across integrations, session-explorer, and test-management modules.

Changes

Cohort / File(s)	Summary
Figma Integration Documentation Restructuring docs/modules/integrations/nav.adoc, docs/modules/integrations/pages/index.adoc	Removed Figma navigation entries from nav.adoc; added four Figma-related page aliases to index.adoc
Validation/Remediation Documentation Reorganization docs/modules/session-explorer/nav.adoc, docs/modules/session-explorer/pages/validations/index.adoc, docs/modules/test-management/nav.adoc, docs/modules/test-management/pages/index.adoc	Removed validation navigation links from session-explorer and test-management nav files; added validation page aliases to test-management index; replaced cross-reference with page alias in session-explorer validations index; added remediation subsection links to test-management nav

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

• All changes are documentation-only with no logic or code modifications
• Consistent pattern of removing navigation entries and adding page aliases
• Straightforward link and alias additions/removals with minimal cognitive load

Possibly related PRs

• Tosca integration #370: Modifies integrations documentation navigation structure (docs/modules/integrations/nav.adoc and pages index) — directly overlaps with Figma integration changes in this PR

Suggested reviewers

• erincbailey
• tungmhoang

Poem

🐰 A rabbit hops through docs so neat,
Rearranging links with twitching feet,
Aliases bloom where nav once grew,
Navigation now refreshed anew! 📚✨

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main changes: removing documentation pages and adding redirects for unpublished Figma and validation content.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch remove-validation-figma-pages

---

📜 Recent review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2378bb1 and 8b9e3a7.

📒 Files selected for processing (3)

• docs/modules/integrations/pages/index.adoc (1 hunks)
• docs/modules/session-explorer/pages/validations/index.adoc (1 hunks)
• docs/modules/test-management/pages/index.adoc (1 hunks)

🚧 Files skipped from review as they are similar to previous changes (1)

• docs/modules/integrations/pages/index.adoc

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)

• GitHub Check: Test Build
• GitHub Check: publish-docs-test

🔇 Additional comments (2)

docs/modules/session-explorer/pages/validations/index.adoc (1)

8-10: Verify the page-alias path matches the unpublished file location.

Line 10 adds a page-alias for _validate-ui-design.adoc, but it's unclear if this path is relative to the current file or absolute. Given that the removed xref on line 9 likely referenced a sibling file, the alias path should be verified to ensure it resolves correctly after the validate-ui-design.adoc file is prefixed with underscore.

🔎 Verification needed

Confirm:

1. The removed line 9 (likely xref:session-explorer:validations/validate-ui-design.adoc[]) will have its source file prefixed with _ in the same directory.
2. The alias path _validate-ui-design.adoc correctly resolves from the current location (validations/index.adoc context).

If the file is in a different relative location (e.g., unpublished in a parent or sibling directory), the path should be adjusted accordingly.

docs/modules/test-management/pages/index.adoc (1)

11-12: Verify the page-alias paths and target file existence.

All four files exist in the _validation subdirectory and are correctly referenced as unpublished pages, which Antora adds to the content catalog and allows to be referenced via page-aliases. The paths follow standard Antora conventions using pages-relative directory syntax with proper .adoc file extensions.

Verification confirms:

1. _validation/index.adoc exists
2. _validation/color-text-validation.adoc exists
3. _validation/performance-validation.adoc exists
4. _validation/text-validation.adoc exists

The paths will resolve correctly through Antora's alias mechanism.

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[coderabbitai]

Actionable comments posted: 1

📜 Review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between f8258c3 and 2378bb1.

📒 Files selected for processing (6)

• docs/modules/integrations/nav.adoc (0 hunks)
• docs/modules/integrations/pages/index.adoc (1 hunks)
• docs/modules/session-explorer/nav.adoc (0 hunks)
• docs/modules/session-explorer/pages/validations/validate-accessibility.adoc (1 hunks)
• docs/modules/test-management/nav.adoc (0 hunks)
• docs/modules/test-management/pages/index.adoc (1 hunks)

💤 Files with no reviewable changes (3)

• docs/modules/integrations/nav.adoc
• docs/modules/test-management/nav.adoc
• docs/modules/session-explorer/nav.adoc

🧰 Additional context used

🧠 Learnings (1)

📚 Learning: 2025-12-16T07:27:41.117Z

Learnt from: tungmhoang
Repo: kobiton/docs PR: 395
File: docs/modules/integrations/pages/uipath/mobile-test-uipath.adoc:11-15
Timestamp: 2025-12-16T07:27:41.117Z
Learning: For all documentation files under docs/modules/integrations/pages/ (and its subdirectories) that reference platform version requirements for device support, use 'Kobiton' as the product name (not 'Portal') and express versions without the trailing 'S'. Example: 'Kobiton 4.19.6 and above' instead of 'Portal 4.19.6S and above'.

Applied to files:

• docs/modules/integrations/pages/index.adoc

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)

• GitHub Check: publish-docs-test
• GitHub Check: Test Build

🔇 Additional comments (2)

docs/modules/session-explorer/pages/validations/validate-accessibility.adoc (1)

80-81: Verify that aliased pages are properly unpublished and alias paths are correctly scoped.

The page-alias addition correctly follows Antora syntax, but several aspects require verification to ensure the redirect strategy works as intended:

1. Alias target verification: Confirm that validate-ui-design.adoc is being unpublished (underscore convention) in this PR rather than deleted, ensuring users landing on old links receive a proper redirect.
2. Path scope: Verify that the relative path validate-ui-design.adoc correctly resolves within the same validations/ directory in Antora's routing system.
3. Cross-module consistency: Note that validate-ui-design.adoc is also aliased in integrations/pages/index.adoc—confirm this dual-alias structure is intentional and won't cause routing conflicts.

docs/modules/test-management/pages/index.adoc (1)

10-12: Verify that all unpublished validation pages are correctly referenced in the alias list.

The page-aliases directive uses correct Antora syntax and appropriately consolidates multiple validation pages into a single redirect target. However, confirm the following:

1. Completeness: Verify that the four aliased validation pages (validation/index.adoc, validation/color-text-validation.adoc, validation/performance-validation.adoc, validation/text-validation.adoc) represent all validation pages being unpublished from the test-management module.
2. Path resolution: Confirm that relative paths with the validation/ prefix correctly resolve within the test-management module structure in Antora.
3. Navigation synchronization: Ensure the removed validation subsection links in test-management/nav.adoc (mentioned in the AI summary) align exactly with these aliased pages.