[Findability] Landing page prototype#3250
Draft
KOTungseth wants to merge 2 commits intomainfrom
Draft
Conversation
Replaces the previous hero/card layout with a search-first design: - Version disambiguation banner with link to 8.x docs - Prominent search bar with What's new ribbon - Analytics-driven popular destinations grid - Get started cards (local, cloud trial, fundamentals) - Browse by solution (Search, Observability, Security) with sub-links - Full product index categorized by stack, cloud, ingest, query languages, APM agents, and developer tools - Scoped CSS replacing Tailwind utility classes Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Prevent the landing page prototype from leaking reset and link styles into the shared Elastic navigation chrome. Co-authored-by: OpenAI GPT-5.5 <noreply@openai.com> Co-authored-by: Cursor <cursoragent@cursor.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes https://github.com/elastic/docs-content-internal/issues/1018.
Summary of changes
Replaces the previous hero/card layout with a search-first design:
Guiding principles for changes
Most landing page guidance is written for marketing and ecommerce contexts, which primarily focus on conversion funnels, single CTAs, social proof, and urgency. That advice doesn't translate cleanly to documentation.
A documentation landing page has a different job. Users aren't being persuaded because they've already decided to use the product. They arrive with a specific task in mind, at varying levels of familiarity with the docs site structure. The landing page succeeds when it gets them to the right content as quickly as possible, and fails when it makes them work to find it.
Principle 1: Serve task-focused users first
The majority of users landing on the Elastic Docs homepage are focused on completing a specific task. They know what they want and they want to reach it in one click. They are not browsing or evaluating whether to use Elastic.
This prototype is designed for this user first. Every element that isn't a direct route to content is friction.
What this means in practice:
Principle 2: Acknowledge multiple user intents without serving all of them equally
The Elastic Docs landing page typically serves at least three distinct user types:
If we design for all three of these user types equally, we'll produce a cluttered page that serves none of them well.
This design prioritizes in this order:
If you cover the search bar with your hand and ask whether the remaining page structure routes a new user to the right starting point in one click, the getting started content is doing its job. If you ask whether a returning user looking for a specific reference page can find it without thinking, the task-focused routing is also doing its job.
Principle 3: Make version and edition complexity visible, not hidden
The Elastic Docs site serves multiple product versions, deployment models, and products. Users frequently don't know the version they're on, which version the docs default to, or where to go if they're on an older version. We want to make sure we are not confusing users with our version/model/product layers. A user who follows installation instructions for the wrong version loses significant time and trust.
What this means in practice:
Principle 4: Distinguish between navigation and content
The Elastic Docs landing page is navigation infrastructure, not content. Its job is to route users to content, not to contain it. This distinction matters because it shapes what belongs on the page. Landing pages that try to contain content (summarizing every product area, explaining what Elasticsearch is, describing use cases) become long, hard to maintain, and slow to scan.
What belongs on a docs landing page:
What doesn't belong on a docs landing page:
Principle 5: Name things the way users name them
The landing page uses task-base terms that don't always match how users search. This creates a gap between the landing page labels and the search terms users arrive with.
🤖 Generated with Claude Code.