Skip to content

Commit

Permalink
Educator Updates (#6562) (#6563)
Browse files Browse the repository at this point in the history
  • Loading branch information
kiki-lee authored Nov 23, 2024
1 parent 7c9e2d8 commit 4657afa
Show file tree
Hide file tree
Showing 16 changed files with 108 additions and 18 deletions.
77 changes: 77 additions & 0 deletions docs/courses/downloading-materials.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
![TEALS Intro CS Banner](/static/courses/teals-introcs-banner.png)

# Material Access Overview

In an effort to keep educator materials, answer keys, and assessments safe from curious eyes, we do require teachers to be [GitHub Educator Verified](https://makecode.com/github-teacher-verification) before they can access the curriculum.

https://youtu.be/RASnIIAXJaY


The Introduction to Computer Science with MakeCode Arcade curriculum is a full academic year course designed to be taught for introductory programming classes in High School. The curriculum is free and uses web-based technology and tools that can be accessed across platforms and devices.


# Downloading and Updating Curriculum

Once you are verified, please follow the steps below to [download the course](https://youtu.be/RASnIIAXJaY).

## 1. Find the Curriculum

At the moment, the _Intro to Computer Science with MakeCode Arcade_ course utilizes a GitHub repo for its content. Once you are approved as a GitHub educator, you can join the repo by visiting https://aka.ms/TEALSintroCS. While it’s not possible to open many of these files directly from GitHub, it is fairly simple to either download a copy of the files to your own machine or create a “branch” of the repo that keeps you connected in the case of changes or updates.

When using the Intro to CS with Arcade curriculum on GitHub, an entry-level user will most-likely want to download the entire course onto their own machine so that they can easily access it whenever they like without needing to be connected to the internet.

## 2. Copy the Curriculum
The simplest way to make that happen is to navigate to the repo and click the green “Code” button above the file navigation pane on the right side. This will open a dialog window that allows you to download the entire package as a ZIP folder. More advanced users can clone the repo using Git using the URL from the same dialog window.

![Download Zip](/static/educator/download-zip.png)

### Download
Download the ZIP file to your computer. Once expanded, you will have the complete curriculum on your machine, ready to edit however you see fit!

_Note: Make sure to re-download the zipped file from the repo from time to time (ideally around the end of August) to make sure you have the most up-to-date version of the curriculum._

### Clone (Advanced)
If you have more experience with GitHub (or you’re itching to learn) then it might benefit you to create your own branch of the curriculum. This will allow you to keep your curriculum up to date more easily, even if you’ve made changes on your side.

#### Install GitHub on VSCode

To do this, we recommend using Visual Studio Code, which is free and has a wealth of online resources for a beginner who might be looking for advice. Simply download the program at https://code.visualstudio.com/download and install these GitHub plug-ins:
• GitHub Actions
• GitHub Pull Requests
• GitHub Codespaces (Optional)
Now you’re ready to log-in to GitHub and create a branch.

#### Log-in to GitHub on VSCode
On the bottom right of the VSCode window, you should see a profile icon and a settings gear.
![Profile](/static/educator/github-login-1.png)

Click the profile icon to open the menu that will allow you to sign in to GitHub with your educator account.
![Sign In](/static/educator/github-login-2.png)

#### Create a Branch from the Repo
Pulling files from a branch is easy once you have VSCode set up. Just visit the curriculum repo and click the same green “Code” button mentioned above. This time, instead of downloading the zipped file, you’ll click the button next to the URL to copy the address of the repo you want to clone.
![Create Branch](/static/educator/create-branch.png)

There are multiple ways to initiate the branch from VSCode.
![Initiate a new branch](/static/educator/initiate.png)

1. Click “Clone Git Repository…” in the main window
2. Click the “Clone Repository” button in the sidebar
3. Open your Command Palette and type Git: Clone into the text box

In all cases, you should then get a text box at the top of the window where you can paste the URL from the repository that you copied in an earlier step.
![Paste Copied URL](/static/educator/paste-url.png)


VSCode will ask you where you want to copy your files. Choose a location on your computer (local drives work the best.) Remember the folder you chose, because that is where you’ll be accessing the curriculum from as you move forward.

#### Access Your Cloned Files

Your cloned files should now be in the folder you selected. You can use these files in the same way you would have if you had downloaded and unzipped them directly. The main difference with this method is that you are set up to “pull” from that repository again at any time to receive the latest updates.


_Caution: Do not attempt to push or commit any changes. While your permissions likely won’t allow commits back into the master branch, there is a possibility that it will interfere with your ability to easily pull again in the future._

## 3. Follow the Intro to CS thread on the Forum

Our user forum contains the most up to date information on all of our activities and curriculum sets. For update notices, tips, tricks, or questions, please visit [https://forum.makecode.com/c/teals-intro-cs] (https://forum.makecode.com/c/teals-intro-cs) and click the bell for notifications.
10 changes: 6 additions & 4 deletions docs/courses/educator-trainings.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,9 @@ _(Click tile to register for free)_
{
"name": "Intro to MakeCode for CSEd Week 2024",
"description": "Join us for an engaging 50-minute webinar where we'll explore the best MakeCode Hour of Code activities, perfect for Computer Science Education Week!",
"label": "11/14/24 at 4pm PST",
"label": "View the Recording",
"labelClass": "purple ribbon large",
"url":"https://msit.events.teams.microsoft.com/event/5c9177b9-52a5-4aa7-a6ba-a62213830c0e@72f988bf-86f1-41af-91ab-2d7cd011db47",
"url":"https://youtu.be/sT5o01rIQZw",
"imageUrl": "/static/tutorials/bubbles/card.jpg"
}, {
"name": "Instant CSEd Week Prep",
Expand All @@ -36,9 +36,9 @@ _(Click tile to register for free)_
{
"name": "Tips and Tricks for Intro to CS with Arcade",
"description": "Discover exciting tips, tricks, and features meant to make your classroom experience as smooth as possible",
"label": "11/07/24 at 4pm PST",
"label": "View the Recording",
"labelClass": "purple ribbon large",
"url":"https://msit.events.teams.microsoft.com/event/081611d2-a02f-4f0f-9d7f-c10b97020acb@72f988bf-86f1-41af-91ab-2d7cd011db47",
"url":"https://youtu.be/zFqY9P5KtcA",
"imageUrl": "https://img-prod-cms-rt-microsoft-com.akamaized.net/cms/api/am/imageFileData/RWOYCd?ver=bf04&q=90&m=6&h=291&w=517&b=%23FFFFFFFF&l=f&o=t"
}, {
"name": "Intro to CS - Ask Me Anything",
Expand All @@ -61,6 +61,8 @@ In addition to the trainings found here, Arcade and micro:bit occasionally provi

## See also

[Previous Webinars](https://www.youtube.com/playlist?list=PLUgoavxKsVdWuplcbeKe69efv7EF1m0bO) <br/>
[YouTube Educator Channel](https://www.youtube.com/@MSMakeCode) <br/>
[Arcade Courses Home Page](https://arcade.makecode.com/courses) <br/>
[micro:bit Courses Home Page](https://makecode.microbit.org/courses) <br/>
[Minecraft Lessons Home Page](https://education.minecraft.net/en-us/resources/explore-lessons)
10 changes: 10 additions & 0 deletions docs/courses/introcs.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,10 @@ The Introduction to Computer Science with MakeCode Arcade curriculum is designed

## Course Outline

### New!
Student facing skillmaps and tutorials for Units 0-3 available [here](https://arcade.makecode.com/courses/csintro).<br/>
[https://arcade.makecode.com/courses/csintro](https://arcade.makecode.com/courses/csintro)

### Semester 1

* **Unit 0 Beginnings** – Students learn about the course, the classroom environment, algorithms, and the MakeCode Arcade environment.
Expand Down Expand Up @@ -46,6 +50,7 @@ The course materials include:
>* Student guide word document
* PowerPoint slide decks for classroom lectures with talking points in the Notes section
* Student projects, labs and activities include Bell Ringers (with solutions where appropriate)
* NEW: [Student-facing tutorials for Units 0-3](https://arcade.makecode.com/courses/csintro)

### ~ reminder

Expand All @@ -56,3 +61,8 @@ You must be a verified educator to download the course materials. Please create
Download the course materials: https://aka.ms/TEALSintroCS

### ~

## Getting Started

For a simple, step-by-step guide to getting started, please visit the [Intro to CS channel on our forum](https://forum.makecode.com/t/getting-started-with-intro-to-cs-with-makecode-arcade/31835).

3 changes: 1 addition & 2 deletions docs/diy-hardware.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,7 @@ Choose one of these projects to create your own Arcade game console, cabinet, or
"name": "Arcade cabinet",
"description": "Full size Arcade cabinet powered by a Raspberry Pi.",
"imageUrl": "/static/hardware/raspberry-pi/wooden-cabinet/gallery.jpg",
"url": "/hardware/raspberry-pi/wooden-cabinet",
"variant": "hw---rpi"
"url": "/hardware/cabinets"
},
{
"name": "Shoebox Controller",
Expand Down
4 changes: 2 additions & 2 deletions docs/educators.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,8 +36,8 @@ We have gathered all of our best educator resources and collected them all right
"imageUrl": "/static/skillmap/story/story-comp.png"
},{
"name": "Educator Training",
"description": "Summer trainings are now in session!",
"url":"/courses/summer-training",
"description": "Learn more about MakeCode!",
"url":"/courses/educator-trainings",
"imageUrl": "/static/livestream-games/hamlet.png"
}
]
Expand Down
12 changes: 6 additions & 6 deletions docs/hardware/arcade-cabinets/full-size-kiosk.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,28 +34,28 @@ The cabinet is built out of 3 - 8' x 4' plywood sheets of 1/2" thickness.

## Template

This [SVG template](/hardware/cabinet.svg) will serve as the outline for the top cabinet on your CNC, or you can print out the pieces at full-scale and follow along the outline with a jigsaw.
This [SVG template](/hardware/arcade-cabinets/cabinet.svg) will serve as the outline for the top cabinet on your CNC, or you can print out the pieces at full-scale and follow along the outline with a jigsaw.

![Top Template](/static/hardware/arcade-kiosks/arcade-cabinet.png)
[Download top of cabinet here...](/hardware/cabinet.svg)
[Download top of cabinet here...](/hardware/arcade-cabinets/cabinet.svg)

<br/>

The following [SVG template](/hardware/control-panel.svg) provides the outline for the cuts in the control panel that allow you to add the two-player buttons and joysticks.
The following [SVG template](/hardware/arcade-cabinets/control-panel.svg) provides the outline for the cuts in the control panel that allow you to add the two-player buttons and joysticks.

![Control Panel Template](/static/hardware/arcade-kiosks/control-panel-image.png)
[Download control panel cuts here...](/hardware/control-panel.svg)
[Download control panel cuts here...](/hardware/arcade-cabinets/control-panel.svg)

<br/>

## Kiosk Top Instructions


* Cut your cabinet pieces from plywood as indicated in the [SVG file](/hardware/control-panel.svg).
* Cut your cabinet pieces from plywood as indicated in the [SVG file](/hardware/arcade-cabinets/control-panel.svg).

![Cutting the template](/static/hardware/arcade-kiosks/cnc.png)

* Cut the control panel from the second [SVG file](/static/hardware/arcade-kiosks/control-panel-image.png).
* Cut the control panel from the second [Control panel image](/static/hardware/arcade-kiosks/control-panel-image.png).

![Rough edges](/static/hardware/arcade-kiosks/control-panel-image.png)<br/>

Expand Down
6 changes: 4 additions & 2 deletions docs/hour-of-code/all.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,9 @@ Join us in celebrating Computer Science Education Week by playing, designing, an
}
]
```
<br/><br/>
[Click here to access educator resources for the above activities.](https://1drv.ms/f/s!AqsgsTyHBmRBpVuQI9q-h2yeQD5m?e=O88oeA)


## Previous Activities

Expand Down Expand Up @@ -70,8 +73,7 @@ Join us in celebrating Computer Science Education Week by playing, designing, an

## See also

[Sparks Flying](aka.ms/prehistoric)<br/>
[Sparks Flying JR](aka.ms/sparky)<br/>
[Code a Carnival Curriculum](https://aka.ms/carnivalTeacher)<br/>
[2022 Hour of Code](/hour-of-code-2022)<br/>
[2021 Hour of Code](/hour-of-code-2021)<br/>
[2020 Hour of Code](/hour-of-code-2020)
Expand Down
Binary file added docs/static/educator/create-branch.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/static/educator/download-zip.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/static/educator/github-login-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/static/educator/github-login-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/static/educator/initiate.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/static/educator/paste-url.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/static/educator/pull.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/tutorials.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@
"imageUrl": "/static/skillmap/backgrounds/target-comp.gif",
"largeImageUrl": "/static/skillmap/backgrounds/target-comp.gif",
"label": "Video tutorial",
"labelClass": "ribbon"
"labelClass": "teal ribbon large"
}, {
"name": "Time Flies",
"description": "Help a frog catch a fly before the timer runs out in this game jam themed tutorial!",
Expand Down
2 changes: 1 addition & 1 deletion pxtarget.json
Original file line number Diff line number Diff line change
Expand Up @@ -734,7 +734,7 @@
"lockedImage": "/static/badges/badge-jungle-locked.png",
"sourceURL": "https://www.makecode.com/api/md/arcade/skillmap/jungle",
"type": "skillmap-completion",
"title": "Jungle Monkey"
"title": "Jungle Jump"
},
{
"id": "skillmap-completion-space",
Expand Down

0 comments on commit 4657afa

Please sign in to comment.