Updates Get started page

[kosabogi]

Overview

This PR modifies the Get started guide to match the current flow. After creating a serverless project, users now land on the Home page instead of the Getting Started page.

Related issue

#154

Preview

[github-actions]

A documentation preview will be available soon.

• 🔨 Buildkite builds
• 📚 HTML diff
• 📙 Preview page

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

[kosabogi]

run docs-build

[leemthompo]

We might want to consider a more substantive revision given that the automated index creation process is now front and centre. We can chat about this next week. :)

[kosabogi]

run docs-build

[kosabogi]

run docs-build

[leemthompo]

Just quick note about examples.

[leemthompo]

@kosabogi Here's what I'm thinking would be the most helpful for users, with 3 branches in terms of getting started. We should make these 3 options clear on this page:

1. Follow the new guided index creation flow
2. Follow the in-product Getting started
3. Add data using another method and explore on your own

Concretely, that means we should delegate the ingest and search stuff to the UI. So we can remove the ingest and search instructions.

The Continue on your own section should be:

• Renamed to better fit number 3.
• Outline all the potential ingest options, basically this image in text.
  • Alternatively we could just link to the Ingest page
    • Then in a follow up make that whole Ingest section simply a single page that reflects all ingest options.
• Provide nice links to quickstarts, notebooks etc. We should definitely highlight Playground as a great place to go once you've got some data in.

The On this page might look something like this after these changes.

[leemthompo]

I like the idea of breaking out the API key creation into a standalone page. I also think that in the existing get started guide the
Copy URL and Test connection steps are helpful for users.

Perhaps we could also have these on that new page, and maybe give the page a more general title like 'Connecting to your Elasticsearch Serverless endpoint'

[kosabogi]

run docs-build

[kosabogi]

@kosabogi Here's what I'm thinking would be the most helpful for users, with 3 branches in terms of getting started. We should make these 3 options clear on this page:

1. Follow the new guided index creation flow
2. Follow the in-product Getting started
3. Add data using another method and explore on your own

Concretely, that means we should delegate the ingest and search stuff to the UI. So we can remove the ingest and search instructions.

The Continue on your own section should be:

• Renamed to better fit number 3.

• Outline all the potential ingest options, basically this image in text.

  • Alternatively we could just link to the Ingest page

    • Then in a follow up make that whole Ingest section simply a single page that reflects all ingest options.

• Provide nice links to quickstarts, notebooks etc. We should definitely highlight Playground as a great place to go once you've got some data in.

The On this page might look something like this after these changes.

Thanks for the feedback @leemthompo !

I updated the structure and provided some quick start guides as well. Please let me know if you have any suggestions or additions related to those.

[leemthompo]

Looking good, few suggestions here to tighten up the connection details page.

I think the get-started page still needs a bit of love:

I think we should make the 3 getting started options explicit:

• Option 1: Follow the guided index flow
• Option 2: Follow the in-product getting started tutorial
• Option 3: Explore on your own, where you'll need:
  • Your connection details
  • Choose an ingestion option (just link to ingest page)
  • Once you've got data in, try Playground

[leemthompo]

Looking good, I have a few minor suggestions. This should be close to the finish line, thanks for iterating!

[leemthompo]

Looking great! Final few tweaks, I'll approve once those are made because otherwise will have to re-review anyway :)

[leemthompo]

Thanks for iterating! This is a nice improvement for new users looking to get started. 🚢