Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore(docs): update main tutorial to incorporate TS Updates to create-gatsby #34890

Merged
merged 12 commits into from
Feb 22, 2022
Merged

chore(docs): update main tutorial to incorporate TS Updates to create-gatsby #34890

Changes from all commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
af48a3e
initial doc update
marvinjude Feb 21, 2022
2b07a75
improve clarity
marvinjude Feb 21, 2022
4eccc76
update numbering
marvinjude Feb 21, 2022
e4614ab
update docs
marvinjude Feb 21, 2022
64448a0
add ts doc reference
marvinjude Feb 21, 2022
5a2fda2
Update docs/docs/tutorial/part-1/index.mdx
marvinjude Feb 22, 2022
36ae0be
Update docs/docs/tutorial/part-1/index.mdx
marvinjude Feb 22, 2022
4c87e73
Update docs/docs/tutorial/part-1/index.mdx
marvinjude Feb 22, 2022
463318b
update docs
marvinjude Feb 22, 2022
a02e376
Update docs/docs/tutorial/part-1/index.mdx
marvinjude Feb 22, 2022
eb1c8eb
Update docs/docs/tutorial/part-1/index.mdx
marvinjude Feb 22, 2022
fef8d4b
Update index.mdx
LekoArts Feb 22, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 20 additions & 6 deletions docs/docs/tutorial/part-1/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ To create your first Gatsby site, you're going to use a command from the Gatsby

<Announcement style={{marginBottom: "1.5rem"}}>

**Note:** For this Tutorial, your Gatsby CLI should be v3 or newer. To check what version you have installed, run the following command:
**Note:** For this Tutorial, your Gatsby CLI should be v4.8 or newer. To check what version you have installed, run the following command:

```shell
gatsby --version
Expand Down Expand Up @@ -106,7 +106,21 @@ What would you like to name the folder where your site will be created?
✔ Desktop/ my-first-gatsby-site
```

5. When the prompt asks, **"Will you be using a CMS?"** select **"No (or I'll add it later)"**.
5. When the prompt asks, **"Will you be using JavaScript or TypeScript?"** choose **JavaScript**.

```shell
Will you be using JavaScript or TypeScript?
❯ JavaScript
TypeScript
```

<Announcement style={{marginBottom: "1.5rem"}}>

This tutorial doesn't require any prior TypeScript knowledge as it uses JavaScript. If you're familiar with TypeScript you can read the [Gatsby and TypeScript guide](/how-to/custom-configuration/typescript/) to learn about typings, files, and conventions. If you want to use TypeScript we recommend going through the tutorial first and then only afterwards convert the project to TypeScript.

</Announcement>

6. When the prompt asks, **"Will you be using a CMS?"** select **"No (or I'll add it later)"**.

```shell
✔ Will you be using a CMS?
Expand All @@ -121,21 +135,21 @@ But in this first site, you'll set things up manually to learn about how Gatsby'

</Announcement>

6. When the prompt asks, **"Would you like to install a styling system?"** select **"No (or I'll add it later)"**. (You'll add styles manually later.)
7. When the prompt asks, **"Would you like to install a styling system?"** select **"No (or I'll add it later)"**. (You'll add styles manually later.)

```shell
✔ Would you like to install a styling system?
· No (or I'll add it later)
```

7. When the prompt asks, **"Would you like to install additional features with other plugins?"** use the arrow and Enter keys to select **"Done"**.
8. When the prompt asks, **"Would you like to install additional features with other plugins?"** use the arrow and Enter keys to select **"Done"**.

```shell
✔ Would you like to install additional features with other plugins?
· Done
```

8. The prompt will show you a summary of what `gatsby new` will do. It should look something like the output below.
9. The prompt will show you a summary of what `gatsby new` will do. It should look something like the output below.

```shell
Thanks! Here's what we'll now do:
Expand All @@ -146,7 +160,7 @@ Thanks! Here's what we'll now do:
? Shall we do this? (Y/n) › Yes
```

9. When the prompt asks, **"Shall we do this?"** enter **"Y"**. The `gatsby new` command will start building your site. Your internet download speed will affect how long this command takes to run. After it finishes, you should see a message like this:
10. When the prompt asks, **"Shall we do this?"** enter **"Y"**. The `gatsby new` command will start building your site. Your internet download speed will affect how long this command takes to run. After it finishes, you should see a message like this:

```shell
🎉 Your new Gatsby site My First Gatsby Site has been successfully
Expand Down