Overhaul getting started guide

[delucis]

What kind of changes does this PR include?

• Changes or translations of Starlight docs site content

Description

• This PR overhauls the getting started page in docs.
• Main aims:
  • Mention how to start the dev server after creating your project (feedback from this video of someone working through the page).
  • Streamline some of the content and give readers more options to jump into the rest of the docs.
  • More clearly separate the “Getting Started” steps from the other things we’ve shoehorned into this page (“Updating” and “Troubleshooting”).

[changeset-bot]

⚠️ No Changeset found

Latest commit: 2b864ab

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[netlify]

✅ Deploy Preview for astro-starlight ready!

Name	Link
🔨 Latest commit	2b864ab
🔍 Latest deploy log	https://app.netlify.com/sites/astro-starlight/deploys/65441905f3c7790008cb6659
😎 Deploy Preview	https://deploy-preview-1026--astro-starlight.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
Lighthouse	1 paths audited Performance: 100 (no change from production) Accessibility: 100 (no change from production) Best Practices: 100 (no change from production) SEO: 92 (no change from production) PWA: - View the detailed breakdown and full score reports

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[astrobot-houston]

size-limit report 📦

Path	Size
/index.html	5.13 KB (0%)
/_astro/*.js	19.27 KB (0%)
/_astro/*.css	9.72 KB (0%)

[sarah11918]

This looks fabulous, @delucis! Especially love the Next Steps section!

Just a few thoughts going though, but this is wonderful!

[sarah11918]

I LOVE these next steps!

[HiDeoo]

Wow, this is really great. So many improvements all over the place and I love the dev server/next steps sections.

The only thing that I've always found a bit confusing (at least for me as a non-native reader with my definition of theme and we may have already discussed this) is not really related to the changes, but maybe it's more obvious now, is the fact that we say "Starlight is a full-featured documentation theme" and later "Starlight is an Astro integration". Not sure if anything should be done about it, but I thought I'd mention it.

[delucis]

we say "Starlight is a full-featured documentation theme" and later "Starlight is an Astro integration"

Yeah, I think this is part of the issue for ourselves of answering “What is Starlight?” 😅

I’d argue that “theme” and “integration” are not mutually exclusive and in both cases we’re drawing attention to the “built on Astro” aspect, which is important because understanding that is really helpful in knowing what else you can do with Starlight. But I still agree the messaging isn’t perfect there. (And there is also the element that you can also use Starlight without really caring about Astro, at least for basic usage.)

I do think we can improve this in the first paragraph though, will make a suggestion.