Skip to content

Conversation

leemthompo
Copy link
Contributor

@leemthompo leemthompo commented Nov 14, 2024

Summary

Tries to simplify and clarify the CTAs for readers:

  • Added reference to page rendering location
  • Expanded Elasticsearch definition and serverless context
  • Restructured "Get Started" section into cards
  • Added "Learn More" section with cards
  • Removed "How to" section and its subsections
  • Added tip about checking main Elasticsearch docs for beginners

- Added reference to page rendering location
- Expanded Elasticsearch definition and serverless context
- Restructured "Get Started" section into a 4-column card layout with emojis:
 - Create project
 - Connect to Elasticsearch
 - Ingest data
 - Try Search Playground
- Added "Learn More" section with 2 cards:
 - Serverless differences
 - Billing information
- Removed "How to" section and its subsections
- Added tip about checking main Elasticsearch docs for beginners
@leemthompo leemthompo requested a review from a team as a code owner November 14, 2024 13:18
Copy link

A documentation preview will be available soon.

Request a new doc build by commenting
  • Rebuild this PR: run docs-build
  • Rebuild this PR and all Elastic docs: run docs-build rebuild

run docs-build is much faster than run docs-build rebuild. A rebuild should only be needed in rare situations.

If your PR continues to fail for an unknown reason, the doc build pipeline may be broken. Elastic employees can check the pipeline status here.

shainaraskas
shainaraskas previously approved these changes Nov 18, 2024
Copy link
Collaborator

@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.

excellent improvements. enjoy the format

Comment on lines 18 to 14
[discrete]
== Get started
{es} is an open source distributed search and analytics engine, scalable data store, and vector database. It’s optimized for speed and relevance on production-scale workloads. Use {es} to search, index, store, and analyze data of all shapes and sizes.
Copy link
Collaborator

Choose a reason for hiding this comment

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

this feels kinda weird because ES is also the foundation of obs and sec projects. could we reframe the ES project type as the "vanilla/search" option?

something like:

{es} is one of the three available project types on <<intro,{serverless-full}>>.

This project type lets you use the core functionality of {es}: Searching, indexing, storing, and analyzing data of all shapes and sizes.

and then let the es basics page take care of the "what is ES" question?

"lets you use" might feel restrictive - something like "is built for" "is optimized for"?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

nods in agreement, but on the "foundation of obs and sec projects" point I couldn't find a clean way to incorporate that info here but I'm also not too worried about that really

Copy link
Contributor Author

Choose a reason for hiding this comment

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

cleared up intro in 040ebc5

Copy link
Collaborator

Choose a reason for hiding this comment

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

re: the foundational aspects we can revisit if it seems like people are creating additional projects in error

@leemthompo leemthompo merged commit 29ab92a into elastic:main Nov 19, 2024
2 checks passed
@leemthompo leemthompo deleted the es-landing-page branch November 19, 2024 09:25
@leemthompo leemthompo self-assigned this Nov 19, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants