added codespaces instructions

This commit is contained in:
katiesavage 2023-07-06 13:42:43 -07:00
parent 681976fa09
commit 347f96efe1
4 changed files with 26 additions and 4 deletions

View file

@ -4,6 +4,9 @@ In this Welcome, well introduce ourselves, give you the lesson rundown, take
![.NET bot waving](../images/dotnet-bot.svg) ![.NET bot waving](../images/dotnet-bot.svg)
## Prerequisite tools ## Prerequisite tools
In this series, you can use your editor of choice or GitHub Codespaces. Here are some options we suggest:
- [GitHub Codespaces](https://code.visualstudio.com/docs/remote/codespaces) for an in-browser coding environment
- [Visual Studio Code](https://code.visualstudio.com/), with the [C# Dev Kit Extension](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit)
- [Visual Studio](https://aka.ms/WebLearningSeries-git-vsDownload) or [Visual Studio for Mac](https://aka.ms/WebLearningSeries-git-vsmacDownload) - check out our [more detailed instructions](/1-welcome/how-to-install-vs.md) for extra help - [Visual Studio](https://aka.ms/WebLearningSeries-git-vsDownload) or [Visual Studio for Mac](https://aka.ms/WebLearningSeries-git-vsmacDownload) - check out our [more detailed instructions](/1-welcome/how-to-install-vs.md) for extra help
- [.NET 6 SDK](https://aka.ms/WebLearningSeries-git-dotnetDownload) - [.NET 6 SDK](https://aka.ms/WebLearningSeries-git-dotnetDownload)

View file

@ -14,6 +14,15 @@ In Razor Pages applications, youll write your logic in a Page Model class, an
## Installing the tools ## Installing the tools
You can utilize your editor of choice for this course. Below we've included instructions for GitHub Codespaces and Visual Studio.
### GitHub Codespaces
1. Open a GitHub Codespace. To do this, simply select the green **Code** button. Then click the **+** to create a Codespace on the main branch.
2. Navigate to the project files in the [0-start/RazorPagesPizza folder](0-start/RazorPagesPizza)
### Visual Studio
We'll be using Visual Studio 2022 for whole course. If you don't have Visual Studio 2022 installed, you can follow the [directions here](/1-welcome/how-to-install-vs.md). We'll be using Visual Studio 2022 for whole course. If you don't have Visual Studio 2022 installed, you can follow the [directions here](/1-welcome/how-to-install-vs.md).
## Creating a Razor Pages project ## Creating a Razor Pages project

View file

@ -30,15 +30,22 @@ We'll accomllish this by writing a classic four-in-a-row "Connect Four" game tha
First, let's scaffold a new project for our game. With .NET 6 installed, we can start building our application at the command-line. First, let's scaffold a new project for our game. With .NET 6 installed, we can start building our application at the command-line.
**GitHub Codespaces Instructions**
1. Open a GitHub Codespace. To do this, simply select the green **Code** button. Then click the **+** to create a Codespace on the main branch.
2. Navigate to the project files in the [0-start folder](0-start)
**Visual Studio Instructions**
1. Create a new blazor application in Visual Studio 2022 by choosing the "File - New... - Project" menu. 1. Create a new blazor application in Visual Studio 2022 by choosing the "File - New... - Project" menu.
1. Choose a "Blazor WebAssembly App" from the list of templates and name it "ConnectFour". Click next 2. Choose a "Blazor WebAssembly App" from the list of templates and name it "ConnectFour". Click next
1. Choose the .NET 6 framework, Authentication type should be set to "None" and uncheck the "ASP.NET Core hosted" checkbox. 3. Choose the .NET 6 framework, Authentication type should be set to "None" and uncheck the "ASP.NET Core hosted" checkbox.
This should create a _ConnectFour_ directory containing our application. This should create a _ConnectFour_ directory containing our application.
2. Run the app by pressing <kbd>F5</kbd> in Visual Studio 2022. This builds the app and hosts it on a random port between 5000 and 5300. HTTPS has a port selected for it in the range of 7000 to 7300. 4. Run the app by pressing <kbd>F5</kbd> in Visual Studio 2022. This builds the app and hosts it on a random port between 5000 and 5300. HTTPS has a port selected for it in the range of 7000 to 7300.
Your Output Window should report content similar to the following: Your Output Window should report content similar to the following:
@ -56,7 +63,7 @@ First, let's scaffold a new project for our game. With .NET 6 installed, we can
Content root path: C:\dev\ConnectFour Content root path: C:\dev\ConnectFour
``` ```
1. Let's navigate to the address our web server announced it's serving the application at. You might be able to Ctrl+Click on the address in your terminal, or just copy the address into your browser. In the above sample, we would navigate to `http://localhost:5136`. You should be presented with the following welcome screen in your browser: 5. Let's navigate to the address our web server announced it's serving the application at. You might be able to Ctrl+Click on the address in your terminal, or just copy the address into your browser. In the above sample, we would navigate to `http://localhost:5136`. You should be presented with the following welcome screen in your browser:
![Screenshot from the new Blazor Template](img/1-NewTemplate.png) ![Screenshot from the new Blazor Template](img/1-NewTemplate.png)

View file

@ -13,6 +13,9 @@ Here, you'll find a 6-part series of lessons and projects to get you started bui
## How-to ## How-to
To use this curriculum on your own, fork the entire repo and go into the numbered folders to access the lessons and projects. This series is designed to take 6 weeks, about 1 week per lesson, but feel free to complete it at your own pace. To use this curriculum on your own, fork the entire repo and go into the numbered folders to access the lessons and projects. This series is designed to take 6 weeks, about 1 week per lesson, but feel free to complete it at your own pace.
### Codespace
You can also complete the lesson from your browser using GitHub Codespaces. To open Codespace, simply select the green **Code** button. Then click the **+** to create a Codespace on the main branch.
## Lessons ## Lessons
| | Lesson Name | Learning Objectives | Linked Lesson | | | Lesson Name | Learning Objectives | Linked Lesson |
| :-: | :------------------------------------------------------: | ----------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: | | :-: | :------------------------------------------------------: | ----------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------: |