Skip to content

Strategy for nav headings that make sense in one context but not in another #621

Open
@bmorelli25

Description

@bmorelli25

Summary

Slack thread: https://elastic.slack.com/archives/C05PP2LEC1X/p1740602224538949?thread_ts=1740532178.416139&cid=C05PP2LEC1X

Doc previews currently take all of the content and build it together. This means if you have reference content, release notes, and deprecations, it all gets built to one preview in the preview. For example:

Image

In this screenshot, you'll notice that the release notes and deprecations nav headings are not helpful—hey're just the product name. That's because in the site-wide IA, these nav headings are nested under headings like "Release notes" and "Deprecations". Something like this:

Image

Question

What can we do to improve this experience where a navigation_heading makes sense in the context of the assembler build, but not in the context of the preview build?

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions