Skip to content

Restore /guide navigation experience in ES reference section #2648

@szabosteve

Description

@szabosteve

Overview

Related to #1644

Description

We have received feedback that the new goal-based structure makes it difficult for users who are accustomed to the /guide product-based navigation.

The reorganization around user tasks rather than products has disrupted how many users search for and consume documentation.

For example, users managing specific clusters or studying for certifications struggle to find the right documentation.

Solution

Restore a familiar experience by replicating the elastic.co/guide/index.html structure at elastic.co/docs/reference, mirroring the navigation used in versions 8.18 and earlier.

Proposed tasks for Elasticsearch

  • Create a dedicated Elastic APIs page

  • Pull the following into Elasticsearch:

    • Text analysis: Built in analyzer, Tokenizer, Token filter, Characters filter, Normalizers
    • Ingest processor
    • Aggregations
  • Create a new Machine learning page and pull in the following:

    • Supplied configurations
    • Analysis functions
  • Reorganize the ES reference landing page to replicate the /guide docs landing page

  • Reorganize the Reference landing page to replicate the /guide docs landing page

Metadata

Metadata

Assignees

Labels

Team:DeveloperIssues owned by the Developer Docs Team

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions