diff --git a/docs/src/pages/getting-started.md b/docs/src/pages/getting-started.md index 71b5434ef..b08253ad6 100644 --- a/docs/src/pages/getting-started.md +++ b/docs/src/pages/getting-started.md @@ -3,34 +3,32 @@ layout: ~/layouts/Main.astro title: Getting Started --- - -Astro is modern static site builder. Learn what Astro is all about from [our homepage](https://astro.build/) or [our release post](https://astro.build/blog/introducing-astro). This page is an overview of the Astro documentation and all related resources. +Astro is modern static site builder. Learn what Astro is all about from [our homepage](https://astro.build/) or [our release post](https://astro.build/blog/introducing-astro). This page is an overview of the Astro documentation and all related resources. ## Try Astro -The easiest way to try Astro is to run `npm init astro` in a new directory on your machine. This CLI command will walk you through starting a new Astro project. +The easiest way to try Astro is to run `npm init astro` in a new directory on your machine. This CLI command will walk you through starting a new Astro project. Read our [Installation Guide](/installation) for a full walk-through on getting set up with Astro. ### Online Playgrounds -If you're interested in playing around with Astro in the browser, you can use an online code playground. Try a Hello World template on [CodeSandbox](https://codesandbox.io/s/astro-template-hugb3). - -*Note: some features (ex: Fast Refresh) are currently limited on CodeSandbox.* +If you're interested in playing around with Astro in the browser, you can use an online code playground. Try a Hello World template on [CodeSandbox](https://codesandbox.io/s/astro-template-hugb3). +_Note: some features (ex: Fast Refresh) are currently limited on CodeSandbox._ ## Learn Astro People come to Astro from different backgrounds and with different learning styles. Whether you prefer a more theoretical or a practical approach, we hope you'll find this section helpful. -* If you prefer to **learn by doing**, start with our [examples library](https://github.com/snowpackjs/astro/tree/main/examples). -* If you prefer to **learn concepts step by step**, start with our [basic concepts and guides](/core-concepts/project-structure). +- If you prefer to **learn by doing**, start with our [examples library](https://github.com/snowpackjs/astro/tree/main/examples). +- If you prefer to **learn concepts step by step**, start with our [basic concepts and guides](/core-concepts/project-structure). -Like any unfamiliar technology, Astro does have a learning curve. With practice and some patience, you *will* get the hang of it. +Like any unfamiliar technology, Astro does have a learning curve. With practice and some patience, you _will_ get the hang of it. ### Learn `.astro` Syntax -When you begin to learn Astro, you'll see many files using the `.astro` file extension. This is the **Astro component syntax**: a special HTML-like file format that Astro uses for templating. It was designed to feel familiar to anyone with HTML or JSX experience. +When you begin to learn Astro, you'll see many files using the `.astro` file extension. This is the **Astro component syntax**: a special HTML-like file format that Astro uses for templating. It was designed to feel familiar to anyone with HTML or JSX experience. Our guide on [Astro components](/core-concepts/astro-components) walks you through the new syntax, and is best way to learn. @@ -42,12 +40,11 @@ This documentation section is useful when you want to learn more details about a This documentation always reflects the latest stable version of Astro. Once we hit the v1.0 milestone, we will add the ability to view versioned documentation. - ## Staying Informed The [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter account is the official source for the updates from the Astro team. -We also post release announcements to our [Discord community](https://astro.build/chat) in the #announcements channel. +We also post release announcements to our [Discord community](https://astro.build/chat) in the #announcements channel. Not every Astro release deserves its own blog post, but you can find a detailed changelog for every release in the [`CHANGELOG.md` file in the Astro repository](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md). @@ -57,4 +54,4 @@ If something is missing in the documentation or if you found some part confusing ## Credit -This getting started guide was originally based off of [React's](https://reactjs.org/) getting started guide. \ No newline at end of file +This getting started guide was originally based off of [React's](https://reactjs.org/) getting started guide. diff --git a/docs/src/pages/guides/deploy.md b/docs/src/pages/guides/deploy.md index ca8365e5e..1af97643f 100644 --- a/docs/src/pages/guides/deploy.md +++ b/docs/src/pages/guides/deploy.md @@ -254,4 +254,4 @@ The action will work to deploy your app (watch its progress in your repo's Actio ## Credits -This guide was originally based off of [Vite's](https://vitejs.dev/) well-documented static deploy guide. \ No newline at end of file +This guide was originally based off of [Vite's](https://vitejs.dev/) well-documented static deploy guide.