[DOC]Revise and edit PPL in-product documentation

[vagimeli]

Description

Revises PPL in-produce for clarity and edits grammatical, spelling, and other writing errors.

UX note: The manual opens to the where command section. Update to open to the Overview section. See the following image for reference.

Issues Resolved

opensearch-project/documentation-website#1152

Check List

• New functionality includes testing.
  • All tests pass, including unit test, integration test and doctest
• New functionality has been documented.
  • New functionality has javadoc added
  • New functionality has user manual doc added
• Commits are signed per the DCO using --signoff

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.
For more information on following Developer Certificate of Origin and signing off your commits, please check here.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (80f112a) 44.06% compared to head (a5f621a) 56.32%.
Report is 131 commits behind head on main.

❗ Current head a5f621a differs from pull request most recent head 65ac8c5. Consider uploading reports for the commit 65ac8c5 to get more accurate results

Additional details and impacted files

@@             Coverage Diff             @@
##             main    #1233       +/-   ##
===========================================
+ Coverage   44.06%   56.32%   +12.26%     
===========================================
  Files         329      327        -2     
  Lines       19672    11944     -7728     
  Branches     4685     2741     -1944     
===========================================
- Hits         8669     6728     -1941     
+ Misses      10958     5171     -5787     
  Partials       45       45               

Flag	Coverage Δ
dashboards-observability	56.32% <100.00%> (+12.26%)	⬆️

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.

[vagimeli]

@anirudha I've rewritten the PPL reference manual (in-product) documentation. The old version has several writing and tech inaccuracies. This revised version has gone through tech and editorial review is ready to be published. Who can I work with to get this published? Also, we need to change the page on which the manual opens. It currently opens to the where command section. It needs to open to the Overview section. Thanks for your help in moving this forward.

cc: @hdhalter

[vagimeli]

@anirudha @joshuali925 @hdhalter Is this PR ready to be merged? The content was rewritten, especially for clarity, grammar, and relevancy. It's gone through tech review, doc review, and editorial review. What are the next steps to update the UI changes and publish content to Dashboards?

The following UI updates are needed:

1. Update link to PPL Documentation in Query Workbench. Link should be https://opensearch.org/docs/latest/search-plugins/sql/ppl/index/.
2. Update PPL in-product homepage to open to Overview section instead of the where command section. See following image:

[vagimeli]

@anirudha @joshuali925 @hdhalter Is this PR ready to be merged? The content was rewritten, especially for clarity, grammar, and relevancy. It's gone through tech review, doc review, and editorial review. What are the next steps to update the UI changes and publish content to Dashboards?

The following UI updates are needed:

1. Update link to PPL Documentation in Query Workbench. Link should be https://opensearch.org/docs/latest/search-plugins/sql/ppl/index/.
2. Update PPL in-product homepage to open to Overview section instead of the where command section. See following image:

Thanks for making the UI changes :)

[bbarani]

@anirudha @joshuali925 Whats the next step here? Can we target this for 2.12.0 release? What are the next steps to update the UI changes and publish content to Dashboards?