Skip to content

Conversation

leemthompo
Copy link
Contributor

@leemthompo leemthompo commented Sep 19, 2025

contributes to elastic/docs-content#1644

  • Groups related sections together in a more principled fashion.
  • Nothing is removed or edited here, only shifted around in the nav.

Notable changes:

  • Moved the Text analysis and Scripting languages reference sections to be grouped under Elasticsearch, rather than as children of other topics.
  • Relocated the Kibana and Cloud documentation sections to appear higher in the navigation
  • Adjusted the placement of the Ingestion tools section, moving it up in the hierarchy and grouping EDOT as a child
    • Alphabetize ingestion tools

Screenshots

✅ NEW

Screenshot 2025-09-19 at 15 50 12
OLD ❌ Screenshot 2025-09-19 at 15 51 59

@leemthompo leemthompo changed the title [TEST] Reference nav changes [TEST] Reference nav reshuffles Sep 19, 2025
@leemthompo leemthompo marked this pull request as ready for review October 9, 2025 16:08
@leemthompo leemthompo requested review from a team as code owners October 9, 2025 16:08
@leemthompo leemthompo requested a review from Mpdreamz October 9, 2025 16:08
@shainaraskas
Copy link
Contributor

is this still a test?

@leemthompo leemthompo changed the title [TEST] Reference nav reshuffles Reference nav reshuffles Oct 10, 2025
@leemthompo
Copy link
Contributor Author

@shainaraskas sorry nope it's no longer a test, this is the real life... fixed the PR title

@leemthompo leemthompo removed the request for review from Mpdreamz October 10, 2025 07:51
@leemthompo leemthompo assigned reakaleek and unassigned reakaleek Oct 10, 2025
@leemthompo leemthompo requested a review from reakaleek October 10, 2025 07:52
Copy link
Contributor

@shainaraskas shainaraskas left a comment

Choose a reason for hiding this comment

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

might be nice for the next reviewer if you expand the sections that were impacted in your screenshots - found reviewing this to be a little difficult without the preview.

I think this all looks fine, with the exception of what's left of the data analysis section. it's not clearly scoped enough to stand together (contains a mixture of docs related to ML, kibana canvas, and something called the infrastructure app which I have no idea about - perhaps related to apm/obs?)

might not be possible in this PR but would like to know if there is a plan to reorganize that content so it is more discoverable.

Comment on lines +231 to +234
# Text analysis
# https://github.com/elastic/elasticsearch/blob/main/docs/reference/text-analysis/toc.yml
- toc: elasticsearch://reference/text-analysis
path_prefix: reference/text-analysis
Copy link
Contributor

Choose a reason for hiding this comment

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

assuming that the data analysis overview will be updated to reflect this new structure (as well as the other overviews for impacted sections)?


# Data analysis
# https://github.com/elastic/docs-content/blob/main/reference/data-analysis/toc.yml
- toc: docs-content://reference/data-analysis
Copy link
Contributor

Choose a reason for hiding this comment

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

a little confused about what is left in this section. keeping the ML stuff with the canvas stuff feels a little strange

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants