Skip to content

Conversation

@kylehounslow
Copy link
Contributor

@kylehounslow kylehounslow commented Dec 18, 2025

Description

Recent migration to markdown in sql repo (opensearch-project/sql#4912) is breaking links for inline documentation. This PR updates links to use .md extension

fix: [Explore] update ppl inline docs links from .rst to .md

Issues Resolved

NA

Screenshot

NA

Testing the changes

Current link: https://github.com/opensearch-project/sql/blob/main/docs/user/ppl/cmd/join.rst

New link: https://github.com/opensearch-project/sql/blob/main/docs/user/ppl/cmd/join.md

Changelog

  • skip

Check List

  • All tests pass
    • yarn test:jest
    • yarn test:jest_integration
  • New functionality includes testing.
  • New functionality has been documented.
  • Update CHANGELOG.md
  • Commits are signed per the DCO using --signoff

Summary by CodeRabbit

  • Documentation
    • Updated documentation references across the app to point to Markdown (.md) pages instead of reStructuredText (.rst) for PPL command docs and data type guidance; in-code comments and documentation mappings were adjusted accordingly.

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

@coderabbitai
Copy link

coderabbitai bot commented Dec 18, 2025

Walkthrough

Documentation links and comments in three files were updated to reference Markdown (.md) documentation instead of reStructuredText (.rst). No functional code, type declarations, or control-flow changes were made.

Changes

Cohort / File(s) Summary
Documentation comment path updates
src/plugins/data/common/osd_field_types/types.ts, src/plugins/query_enhancements/common/utils.ts
Updated inline comment URLs from .rst to .md documentation paths. No code logic changes.
PPL command reference mapping
src/plugins/data/public/antlr/opensearch_ppl/ppl_documentation.ts
Updated PPL command documentation mapping entries to point to .md files instead of .rst. Keys and structure unchanged.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

  • Verify link patterns converted correctly (*.rst*.md) and contain no typos.
  • Confirm referenced .md files exist at the target paths.
  • Quick grep to ensure no remaining .rst references remain where they should be .md.

Suggested reviewers

  • AMoo-Miki
  • virajsanghvi
  • kavilla
  • zhongnansu
  • zengyan-amazon
  • ZilongX
  • manasvinibs

Poem

🐰 I hopped through comments, light and quick,
From .rst to .md — a tidy trick.
Links now sing in Markdown's tune,
I nibble bugs and hum a tune. 🥕✨

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and specifically summarizes the main change: updating PPL inline documentation links from .rst to .md format.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description check ✅ Passed The pull request description follows the required template with all key sections completed: description, issues resolved, testing details, and changelog entry.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

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

@github-actions
Copy link
Contributor

❌ Invalid Prefix For Manual Changeset Creation

Invalid description prefix. Found "fix". Only "skip" entry option is permitted for manual commit of changeset files.

If you were trying to skip the changelog entry, please use the "skip" entry option in the ##Changelog section of your PR description.

@github-actions
Copy link
Contributor

❌ Invalid Prefix For Manual Changeset Creation

Invalid description prefix. Found "fix". Only "skip" entry option is permitted for manual commit of changeset files.

If you were trying to skip the changelog entry, please use the "skip" entry option in the ##Changelog section of your PR description.

@kylehounslow kylehounslow force-pushed the fix/ppl_docs_rst_to_md branch from 14c0533 to 2cb9ab3 Compare December 18, 2025 23:14
@github-actions
Copy link
Contributor

❌ Invalid Prefix For Manual Changeset Creation

Invalid description prefix. Found "[Explore] fix". Only "skip" entry option is permitted for manual commit of changeset files.

If you were trying to skip the changelog entry, please use the "skip" entry option in the ##Changelog section of your PR description.

1 similar comment
@github-actions
Copy link
Contributor

❌ Invalid Prefix For Manual Changeset Creation

Invalid description prefix. Found "[Explore] fix". Only "skip" entry option is permitted for manual commit of changeset files.

If you were trying to skip the changelog entry, please use the "skip" entry option in the ##Changelog section of your PR description.

@github-actions
Copy link
Contributor

❌ Changelog Entry Missing Hyphen

Changelog entries must begin with a hyphen (-).

@github-actions
Copy link
Contributor

❌ Invalid Changelog Heading

The '## Changelog' heading in your PR description is either missing or malformed. Please make sure that your PR description includes a '## Changelog' heading with proper spelling, capitalization, spacing, and Markdown syntax.

@github-actions
Copy link
Contributor

❌ Invalid Prefix For Manual Changeset Creation

Invalid description prefix. Found "fix". Only "skip" entry option is permitted for manual commit of changeset files.

If you were trying to skip the changelog entry, please use the "skip" entry option in the ##Changelog section of your PR description.

@github-actions
Copy link
Contributor

❌ Invalid Prefix For Manual Changeset Creation

Invalid description prefix. Found "fix". Only "skip" entry option is permitted for manual commit of changeset files.

If you were trying to skip the changelog entry, please use the "skip" entry option in the ##Changelog section of your PR description.

@codecov
Copy link

codecov bot commented Dec 18, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 60.63%. Comparing base (0c6278a) to head (ec95c65).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main   #11083      +/-   ##
==========================================
+ Coverage   60.61%   60.63%   +0.01%     
==========================================
  Files        4578     4578              
  Lines      125711   125711              
  Branches    21012    21012              
==========================================
+ Hits        76203    76226      +23     
+ Misses      44088    44066      -22     
+ Partials     5420     5419       -1     
Flag Coverage Δ
Linux_1 26.39% <ø> (ø)
Linux_2 38.25% <ø> (ø)
Linux_3 39.80% <ø> (ø)
Linux_4 33.54% <ø> (-0.01%) ⬇️
Windows_1 26.41% <ø> (+0.01%) ⬆️
Windows_2 38.23% <ø> (?)
Windows_3 39.81% <ø> (ø)
Windows_4 33.54% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@github-actions
Copy link
Contributor

❌ Invalid Prefix For Manual Changeset Creation

Invalid description prefix. Found "fix". Only "skip" entry option is permitted for manual commit of changeset files.

If you were trying to skip the changelog entry, please use the "skip" entry option in the ##Changelog section of your PR description.

2 similar comments
@github-actions
Copy link
Contributor

❌ Invalid Prefix For Manual Changeset Creation

Invalid description prefix. Found "fix". Only "skip" entry option is permitted for manual commit of changeset files.

If you were trying to skip the changelog entry, please use the "skip" entry option in the ##Changelog section of your PR description.

@github-actions
Copy link
Contributor

❌ Invalid Prefix For Manual Changeset Creation

Invalid description prefix. Found "fix". Only "skip" entry option is permitted for manual commit of changeset files.

If you were trying to skip the changelog entry, please use the "skip" entry option in the ##Changelog section of your PR description.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
src/plugins/data/public/antlr/opensearch_ppl/ppl_documentation.ts (1)

11-762: These documentation links point to non-existent .md files and will break user experience.

The referenced documentation files in the OpenSearch SQL repository still use the .rst format in the main branch. Updating the links to .md format would result in broken links (404 errors) for users trying to access inline command documentation. Either the upstream documentation migration has not been completed, or the links should remain pointing to .rst files.

📜 Review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 31826bc and 2cb9ab3.

📒 Files selected for processing (3)
  • src/plugins/data/common/osd_field_types/types.ts (1 hunks)
  • src/plugins/data/public/antlr/opensearch_ppl/ppl_documentation.ts (40 hunks)
  • src/plugins/query_enhancements/common/utils.ts (1 hunks)
⏰ 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). (65)
  • GitHub Check: update-changelog
  • GitHub Check: Run functional tests on Linux (ciGroup6)
  • GitHub Check: Run functional tests on Linux (ciGroup9)
  • GitHub Check: Run cypress tests (osd:ciGroup15Explore)
  • GitHub Check: Run functional tests on Windows (ciGroup7)
  • GitHub Check: Run functional tests on Linux (ciGroup7)
  • GitHub Check: Run cypress tests (osd:ciGroup14Explore)
  • GitHub Check: Run functional tests on Windows (ciGroup8)
  • GitHub Check: Run functional tests on Linux (ciGroup3)
  • GitHub Check: Run functional tests on Windows (ciGroup9)
  • GitHub Check: Run functional tests on Linux (ciGroup4)
  • GitHub Check: Run functional tests on Linux (ciGroup12)
  • GitHub Check: Run functional tests on Linux (ciGroup5)
  • GitHub Check: Run cypress tests (osd:ciGroup16Explore)
  • GitHub Check: Run cypress tests (osd:ciGroup2)
  • GitHub Check: Run functional tests on Windows (ciGroup11)
  • GitHub Check: Run functional tests on Linux (ciGroup10)
  • GitHub Check: Run functional tests on Windows (ciGroup3)
  • GitHub Check: Run functional tests on Linux (ciGroup8)
  • GitHub Check: Run functional tests on Windows (ciGroup10)
  • GitHub Check: Run functional tests on Linux (ciGroup1)
  • GitHub Check: Run cypress tests (osd:ciGroup8)
  • GitHub Check: Run functional tests on Linux (ciGroup13)
  • GitHub Check: Run functional tests on Windows (ciGroup13)
  • GitHub Check: Run cypress tests (osd:ciGroup13Explore)
  • GitHub Check: Run functional tests on Windows (ciGroup5)
  • GitHub Check: Run functional tests on Windows (ciGroup12)
  • GitHub Check: Run functional tests on Windows (ciGroup4)
  • GitHub Check: Run functional tests on Linux (ciGroup11)
  • GitHub Check: Run cypress tests (osd:ciGroup1)
  • GitHub Check: Run cypress tests (osd:ciGroup17Explore)
  • GitHub Check: Run cypress tests (osd:ciGroup11)
  • GitHub Check: Run cypress tests (osd:ciGroup5)
  • GitHub Check: Run functional tests on Windows (ciGroup6)
  • GitHub Check: Run cypress tests (osd:ciGroup12)
  • GitHub Check: Run functional tests on Windows (ciGroup1)
  • GitHub Check: Run cypress tests (osd:ciGroup10Fast)
  • GitHub Check: Run cypress tests (osd:ciGroup6)
  • GitHub Check: Run cypress tests (osd:ciGroup12Explore)
  • GitHub Check: Run cypress tests (osd:ciGroup13)
  • GitHub Check: lighthouse
  • GitHub Check: Run cypress tests (osd:ciGroup15)
  • GitHub Check: Run functional tests on Linux (ciGroup2)
  • GitHub Check: Run cypress tests (osd:ciGroup10Explore)
  • GitHub Check: Run cypress tests (osd:ciGroup14)
  • GitHub Check: Run cypress tests (osd:ciGroup7)
  • GitHub Check: Run cypress tests (osd:ciGroup4)
  • GitHub Check: Run cypress tests (osd:ciGroup10Slow)
  • GitHub Check: Run cypress tests (osd:ciGroup3)
  • GitHub Check: Run cypress tests (osd:ciGroup9)
  • GitHub Check: Build min release artifacts on macOS x64
  • GitHub Check: Build and Verify on Windows (ciGroup2)
  • GitHub Check: Build and Verify on Windows (ciGroup3)
  • GitHub Check: Build and Verify on Windows (ciGroup4)
  • GitHub Check: Build and Verify on Linux (ciGroup3)
  • GitHub Check: Build and Verify on Windows (ciGroup1)
  • GitHub Check: Build and Verify on Linux (ciGroup1)
  • GitHub Check: Build min release artifacts on macOS ARM64
  • GitHub Check: Build and Verify on Linux (ciGroup4)
  • GitHub Check: Build min release artifacts on Windows x64
  • GitHub Check: Build min release artifacts on Linux x64
  • GitHub Check: Run plugin functional tests on Windows
  • GitHub Check: Build min release artifacts on Linux ARM64
  • GitHub Check: Run plugin functional tests on Linux
  • GitHub Check: bundle-analyzer
🔇 Additional comments (2)
src/plugins/query_enhancements/common/utils.ts (1)

143-146: LGTM!

The JSDoc documentation link update from .rst to .md is correct and maintains the reference to the PPL search command documentation.

src/plugins/data/common/osd_field_types/types.ts (1)

100-100: LGTM!

The comment reference update from .rst to .md aligns with the upstream opensearch-project/sql repository's Markdown documentation. The PPL data types documentation exists and is maintained in the referenced format.

Copy link
Member

@joshuali925 joshuali925 left a comment

Choose a reason for hiding this comment

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

thanks

@kylehounslow kylehounslow force-pushed the fix/ppl_docs_rst_to_md branch from 2cb9ab3 to ec95c65 Compare December 19, 2025 23:48
@github-actions
Copy link
Contributor

❌ Invalid Prefix For Manual Changeset Creation

Invalid description prefix. Found "fix". Only "skip" entry option is permitted for manual commit of changeset files.

If you were trying to skip the changelog entry, please use the "skip" entry option in the ##Changelog section of your PR description.

3 similar comments
@github-actions
Copy link
Contributor

❌ Invalid Prefix For Manual Changeset Creation

Invalid description prefix. Found "fix". Only "skip" entry option is permitted for manual commit of changeset files.

If you were trying to skip the changelog entry, please use the "skip" entry option in the ##Changelog section of your PR description.

@github-actions
Copy link
Contributor

❌ Invalid Prefix For Manual Changeset Creation

Invalid description prefix. Found "fix". Only "skip" entry option is permitted for manual commit of changeset files.

If you were trying to skip the changelog entry, please use the "skip" entry option in the ##Changelog section of your PR description.

@github-actions
Copy link
Contributor

❌ Invalid Prefix For Manual Changeset Creation

Invalid description prefix. Found "fix". Only "skip" entry option is permitted for manual commit of changeset files.

If you were trying to skip the changelog entry, please use the "skip" entry option in the ##Changelog section of your PR description.

@github-actions github-actions bot added Skip-Changelog PRs that are too trivial to warrant a changelog or release notes entry and removed failed changeset labels Dec 22, 2025
@TackAdam TackAdam merged commit bbef2db into opensearch-project:main Dec 22, 2025
84 of 90 checks passed
arjunkumargiri pushed a commit to arjunkumargiri/OpenSearch-Dashboards that referenced this pull request Dec 29, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

repeat-contributor Skip-Changelog PRs that are too trivial to warrant a changelog or release notes entry

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants