Add AI data mapping documentation and cross-link Auto Map references#399
Add AI data mapping documentation and cross-link Auto Map references#399VellummyilumVinoth wants to merge 10 commits into
Conversation
|
Note Reviews pausedIt looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the Use the following commands to manage reviews:
Use the checkboxes below for quick actions:
📝 WalkthroughWalkthroughThis pull request introduces a new AI Data Mapping documentation page and integrates it across the documentation suite. The new page provides comprehensive guidance on using automated AI-powered field mapping in WSO2 Integrator, with UI workflows and Ballerina code examples. Existing documentation in data mapper, copilot, and flow editor contexts is updated to link to and reference this new resource. ChangesAI Data Mapping Documentation Suite
Possibly related PRs
Suggested reviewers
Poem
🎯 1 (Trivial) | ⏱️ ~3 minutes 🚥 Pre-merge checks | ✅ 4 | ❌ 1❌ Failed checks (1 warning)
✅ Passed checks (4 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
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. Comment |
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 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
`@en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md`:
- Around line 93-96: Update the misspelled field name in the Accommodation
record and any generated mapping code: change numberOfRoomates to
numberOfRoommates in the type declaration (type Accommodation record { ... })
and update the corresponding mapping logic that references numberOfRoomates so
it uses numberOfRoommates instead; ensure all occurrences (type definition and
generated mapper) are renamed consistently to avoid breaking consumers.
🪄 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: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
Run ID: 11d8519b-71d9-4277-8c99-8b62e79add45
⛔ Files ignored due to path filters (3)
en/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-canvas.pngis excluded by!**/*.pngen/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-copilot-command.pngis excluded by!**/*.pngen/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-result.pngis excluded by!**/*.png
📒 Files selected for processing (8)
en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.mden/docs/develop/integration-artifacts/supporting/data-mapper/data-mapper.mden/docs/develop/integration-artifacts/supporting/data-mapper/mapping-capabilities.mden/docs/develop/transform/ai-assisted-data-mapping.mden/docs/develop/transform/expressions-functions.mden/docs/develop/understand-ide/editors/datamapper-editor.mden/docs/develop/understand-ide/editors/flow-diagram-editor/statement.mden/sidebars.ts
💤 Files with no reviewable changes (1)
- en/docs/develop/transform/ai-assisted-data-mapping.md
6f2bac1 to
34cc0d5
Compare
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 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
`@en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md`:
- Around line 1-6: The page filename ai-data-mapper.md repeats the parent
directory keyword and doesn't align the slug with the title "AI Data Mapping";
rename the file to a shorter slug such as ai-mapping.md, update any inbound
links and sidebar references that point to the old ai-data-mapper path
(including sidebars, TOCs, and cross-doc links), and ensure the frontmatter
title remains "AI Data Mapping" so title and URL keywords match; also search for
occurrences of "ai-data-mapper" in the repo and update them to the new slug to
avoid broken links.
🪄 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: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
Run ID: c423180b-5205-4863-b6d6-314a0f65431e
⛔ Files ignored due to path filters (3)
en/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-canvas.pngis excluded by!**/*.pngen/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-copilot-command.pngis excluded by!**/*.pngen/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-result.pngis excluded by!**/*.png
📒 Files selected for processing (7)
en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.mden/docs/develop/integration-artifacts/supporting/data-mapper/data-mapper.mden/docs/develop/integration-artifacts/supporting/data-mapper/mapping-capabilities.mden/docs/develop/transform/ai-assisted-data-mapping.mden/docs/develop/understand-ide/editors/datamapper-editor.mden/docs/develop/understand-ide/editors/flow-diagram-editor/statement.mden/sidebars.ts
💤 Files with no reviewable changes (1)
- en/docs/develop/transform/ai-assisted-data-mapping.md
✅ Files skipped from review due to trivial changes (3)
- en/docs/develop/understand-ide/editors/datamapper-editor.md
- en/docs/develop/integration-artifacts/supporting/data-mapper/mapping-capabilities.md
- en/sidebars.ts
🚧 Files skipped from review as they are similar to previous changes (2)
- en/docs/develop/integration-artifacts/supporting/data-mapper/data-mapper.md
- en/docs/develop/understand-ide/editors/flow-diagram-editor/statement.md
476f734 to
e080a9e
Compare
There was a problem hiding this comment.
♻️ Duplicate comments (1)
en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md (1)
1-6: 🛠️ Refactor suggestion | 🟠 Major | ⚡ Quick winFilename still violates hierarchy redundancy rule.
The filename
ai-data-mapper.mdrepeats the parent directory keyworddata-mapper, violating the coding guideline: "If a keyword exists in the parent directory, do not repeat it in the URL slug." Rename this file to a shorter slug such asai-mapping.mdand update the inbound link instatement.md(line 56) accordingly.As per coding guidelines: "Check the file path/hierarchy. If a keyword exists in the parent directory, do not repeat it in the URL slug."
🤖 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 `@en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md` around lines 1 - 6, The file ai-data-mapper.md repeats the parent directory keyword and should be renamed to ai-mapping.md; rename the document slug/file from ai-data-mapper.md to ai-mapping.md and update the inbound link in statement.md to point to the new slug (replace any references to "ai-data-mapper" with "ai-mapping") so the URL hierarchy no longer repeats the parent directory keyword.
🤖 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.
Duplicate comments:
In
`@en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md`:
- Around line 1-6: The file ai-data-mapper.md repeats the parent directory
keyword and should be renamed to ai-mapping.md; rename the document slug/file
from ai-data-mapper.md to ai-mapping.md and update the inbound link in
statement.md to point to the new slug (replace any references to
"ai-data-mapper" with "ai-mapping") so the URL hierarchy no longer repeats the
parent directory keyword.
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
Run ID: b84650a5-2879-4166-940b-0232b36efc6e
📒 Files selected for processing (5)
en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.mden/docs/develop/integration-artifacts/supporting/data-mapper/data-mapper.mden/docs/develop/integration-artifacts/supporting/data-mapper/mapping-capabilities.mden/docs/develop/understand-ide/editors/datamapper-editor.mden/docs/develop/understand-ide/editors/flow-diagram-editor/statement.md
✅ Files skipped from review due to trivial changes (3)
- en/docs/develop/integration-artifacts/supporting/data-mapper/data-mapper.md
- en/docs/develop/understand-ide/editors/datamapper-editor.md
- en/docs/develop/integration-artifacts/supporting/data-mapper/mapping-capabilities.md
e49f57f to
75be7b3
Compare
ccba011 to
173d042
Compare
Description
ai-data-mapper.mdpage documenting the AI data mapping feature, including a Visual designer tab with step-by-step screenshots (canvas, Copilot command, result) and a Ballerina code tab showing before/after transformation code.mapping-capabilities.mdto a brief description with a link to the new page, removing duplicated content.ai-assisted-data-mapping.mdfile (stale references to Ballerina Copilot and deprecated UI behaviour) and replaces its inbound link inexpressions-functions.md.Goals
Approach
User stories
Release note
Documentation
Training
Certification
Marketing
Automation tests
Security checks
Samples
Related PRs
Migrations (if applicable)
Test environment
Learning
Summary by CodeRabbit