# Review requested on a Platformer Tutorial and start of a set of Course Resourses

**URL:** <https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355>\
**Category:** Arcade\
**Created:** [March 9, 2020, 1:00pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355 "2020-03-09T13:00:54Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![mickfuzz](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/mickfuzz/32/419_2.png) [@mickfuzz](https://forum.makecode.com/u/mickfuzz)\
**Post date:** [March 9, 2020, 1:00pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/1 "2020-03-09T13:00:54Z")

</div>

## In a nutshell.

I’d like to replicate a course and resource I’ve done for JS in [glich.com](http://glich.com) [http://ggc-examples.glitch.me/](http://ggc-examples.glitch.me/) - in the Make Code Arcade system. [there are more details in this overview doc](https://docs.google.com/document/d/1i0whpxcEeHAVrK2DtFwZofWm98Qq98xIDzxQ5Cok7pU/edit#)

It would be great to help feedback on what direction to take this and the work I’ve done so far.

## Progress so far

The following elements are now ready for review

- Step by Step Tutorials (using MakeCode system) to create that template game - [Part One](https://arcade.makecode.com/beta#tutorial:https://github.com/mickfuzz/makecode-platformer-101) - [Part Two](https://arcade.makecode.com/beta#tutorial:https://github.com/mickfuzz/makecode-platformer-102)
- Template game to remix -[here](https://makecode.com/_2iLfej4d6Rfa)
- Quick Challenge Cards for an intro session - [here](https://docs.google.com/presentation/d/1vgHFm4zSC3YEVAXJORSoDHBFYSBIHK2mSCNfgbpiaHY/edit#slide=id.p)
- A template for the choice of Game Patterns tutorials - [sample here](https://arcade.makecode.com/beta#tutorial:https://github.com/mickfuzz/makecode-platformer-add-an-enemy)

Next Stages

- A course home page to guide the process - something like [https://arcade.makecode.com/courses/csintro1](https://arcade.makecode.com/courses/csintro1) - but with focus on the game design elements - structure based on this resource [https://en.flossmanuals.net/phaser-game-making-in-glitch/\_full/](https://en.flossmanuals.net/phaser-game-making-in-glitch/_full/)

## Help Needed

**User Tutorials getting complex**

It would be good to have more clarity on how to create a functioning tutorial git repo - What are the minimum set of files needed for it to work - I’ve had patchy results resulting in a lot of delay.

[This repo](https://arcade.makecode.com/beta#tutorial:https://github.com/mickfuzz/makecode-platformer-add-an-enemy) doesn’t seem to display correctly even tho’ the README seems identical to [this one created with Tutorial Tool](https://arcade.makecode.com/#tutorial:35388-98331-70939-16259)

Perhaps there is a simpler way to create small scale tutorials like the one above without creating a git repo for each one.

**Course Home Page**

It would be great to be able to create a course that would live [https://arcade.makecode.com/courses/](https://arcade.makecode.com/courses/csintro1) or at least be able to use the similar documentation process.

---

<div class="post-metadata">

**Author:** ![peli](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/peli/32/12_2.png) [@peli](https://forum.makecode.com/u/peli)\
**Post date:** [March 10, 2020, 6:43pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/2 "2020-03-10T18:43:56Z")

</div>

I’ll be recording videos this afternoon on how to create user tutorials. If you go to [https://arcade.makecode.com/beta](https://arcade.makecode.com/beta) you will get additional support for tutorials:

- all .md files have a “external” icon in the explorer that provides a tutorial preview
- if you change the language of the editor, all .md files have a globe icon to add the localized version  
I’ll review your tutorials later this afternoon.

---

<div class="post-metadata">

**Author:** ![peli](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/peli/32/12_2.png) [@peli](https://forum.makecode.com/u/peli)\
**Post date:** [March 10, 2020, 8:01pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/3 "2020-03-10T20:01:48Z")

</div>

> [@mickfuzz](#):
>
> Perhaps there is a simpler way to create small scale tutorials like the one above without creating a git repo for each one.

We support having multiple tutorials in a single repo. You can add new markdown files through the explorer and route to those files.

---

<div class="post-metadata">

**Author:** ![mickfuzz](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/mickfuzz/32/419_2.png) [@mickfuzz](https://forum.makecode.com/u/mickfuzz)\
**Post date:** [March 13, 2020, 11:57am UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/4 "2020-03-13T11:57:05Z")

</div>

Hi there - this sound promising. Thanks for your help so far.

When you say add new files via the explorer. I think you mean in this way

 ![image](https://us1.discourse-cdn.com/flex020/uploads/makecode/original/1X/efa893061cd3f69fcd2bd03feb46cf0a80d455b1.png)

I wasn’t sure how to navigate to this kind of edit page on #beta for the tutorials created in the tool or in Github. So I created one from scratch on the beta site, edited the README.md and added two more md files.

The result looks good here - [https://arcade.makecode.com/#tutorial:https://makecode.com/\_74kACKTV9HAh](https://arcade.makecode.com/#tutorial:https://makecode.com/_74kACKTV9HAh)

But the link routing isn’t working from that first README - I’ve tried the following way

```
## Adding an Enemy 
### Getting Started @unplugged

This is tutorial one in a group that add game mechanics to our starter template, for more see. 

* [Part One](partOne.md)
* [Part Two](partTwo.md)

These steps are part of other which you can find on the home page of this Platformer Making Course. (course link to come)

```

However the resulting link is [https://arcade.makecode.com/partOne.md](https://arcade.makecode.com/partOne.md)

So my questions are…

- What would be the way of linking to these sub md files ideally both relatively and with an full URI.?
- And is this possible to do also with these tutorials living in github repos ?

---

<div class="post-metadata">

**Author:** ![peli](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/peli/32/12_2.png) [@peli](https://forum.makecode.com/u/peli)\
**Post date:** [March 13, 2020, 2:29pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/5 "2020-03-13T14:29:01Z")

</div>

You’ll definitely want to use a GitHub repository to host your tutorials. The shared projects don’t support sub-file routing (and probably never will).

I published a tutorial for micro:bit about creating tutorials; but it also applies to [arcade.makecode.com/beta](http://arcade.makecode.com/beta)

---

<div class="post-metadata">

**Author:** ![peli](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/peli/32/12_2.png) [@peli](https://forum.makecode.com/u/peli)\
**Post date:** [March 13, 2020, 2:30pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/6 "2020-03-13T14:30:34Z")

</div>

As for cross linking tutorials, let me see today about streamlining this. We do turn on GitHub Pages for repositories – so every [https://github.com/OWNER/NAME](https://github.com/OWNER/NAME) repository also has a compiled jekyll web site [https://OWNER.github.io/NAME](https://OWNER.github.io/NAME) web site which starts with the rendered README.md file.  
From there you could link to the deep link to the tutorials. I will publish a guide about it.

---

<div class="post-metadata">

**Author:** ![mickfuzz](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/mickfuzz/32/419_2.png) [@mickfuzz](https://forum.makecode.com/u/mickfuzz)\
**Post date:** [March 13, 2020, 3:19pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/7 "2020-03-13T15:19:10Z")

</div>

Thanks this is helpful - I’ll get there 🙂  
I’ve added a comment in the following video about navigating back to the editor in beta - I think this is one of my problems at the moment.

---

<div class="post-metadata">

**Author:** ![mickfuzz](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/mickfuzz/32/419_2.png) [@mickfuzz](https://forum.makecode.com/u/mickfuzz)\
**Post date:** [March 13, 2020, 3:25pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/8 "2020-03-13T15:25:34Z")

</div>

That would be great. I’ve turned on the git pages on a test directory - so would the link be something like the following?

The standalone file is at  
[https://mickfuzz.github.io/test-tutorial/partOne.md](https://mickfuzz.github.io/test-tutorial/partOne.md)

The routed link be something like this (not working at the moment)

[https://arcade.makecode.com/beta#tutorial:https://mickfuzz.github.io/test-tutorial/partOne.md](https://arcade.makecode.com/beta#tutorial:https://mickfuzz.github.io/test-tutorial/partOne.md)

---

<div class="post-metadata">

**Author:** ![peli](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/peli/32/12_2.png) [@peli](https://forum.makecode.com/u/peli)\
**Post date:** [March 13, 2020, 4:25pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/9 "2020-03-13T16:25:49Z")

</div>

You need to remove the .md extension. Our routing is quite picky at the moment - I need to make it more lenient.

---

<div class="post-metadata">

**Author:** ![peli](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/peli/32/12_2.png) [@peli](https://forum.makecode.com/u/peli)\
**Post date:** [March 13, 2020, 8:28pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/10 "2020-03-13T20:28:10Z")

</div>

So your github project should be listed in the home screen of the editor, and you can simply open it again. I’ll cover that in future videos.

---

<div class="post-metadata">

**Author:** ![mickfuzz](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/mickfuzz/32/419_2.png) [@mickfuzz](https://forum.makecode.com/u/mickfuzz)\
**Post date:** [March 19, 2020, 4:48pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/11 "2020-03-19T16:48:49Z")

</div>

Hi there,  
Thanks again for your help so far. I’ve created one repository with all my tutorials in it now. And I can pull that into the editor at /beta via Import on the front page.

I’m still struggling away with these links.  
I am getting a lot of inconsistencies and errors.

For example I’ve created the same file in the following locations

> <https://github.com/mickfuzz/makecode-platformer-101/blob/master/README.md>

  

> <https://github.com/mickfuzz/makecode-platformer-101/blob/master/tutorialPartOne.md>

In the explorer the preview links both work well.  
The share links in explorer (not pointing to beta)  
[https://arcade.makecode.com/#tutorial:github:mickfuzz/makecode-platformer-101/README](https://arcade.makecode.com/#tutorial:github:mickfuzz/makecode-platformer-101/README) (works)  
[https://arcade.makecode.com/#tutorial:github:mickfuzz/makecode-platformer-101/tutorialPartOne](https://arcade.makecode.com/#tutorial:github:mickfuzz/makecode-platformer-101/tutorialPartOne) (doesn’t work)

I’ve also tried the following links on beta  
[http://arcade.makecode.com/beta#tutorial:https://github.com/mickfuzz/makecode-platformer-101/README](http://arcade.makecode.com/beta#tutorial:https://github.com/mickfuzz/makecode-platformer-101/README) (works)  
[http://arcade.makecode.com/beta#tutorial:https://github.com/mickfuzz/makecode-platformer-101/tutorialPartOne](http://arcade.makecode.com/beta#tutorial:https://github.com/mickfuzz/makecode-platformer-101/tutorialPartOne) (doesn’t work)

I hope using the same file in those two locations is helpful. I’ve been playing around with a lot of different links and trying to get consistent results but not managing. Also are their caching issues when using github? and Can I get around them somehow when testing.

---

<div class="post-metadata">

**Author:** ![mickfuzz](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/mickfuzz/32/419_2.png) [@mickfuzz](https://forum.makecode.com/u/mickfuzz)\
**Post date:** [March 19, 2020, 11:27pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/12 "2020-03-19T23:27:42Z")

</div>

also here’s what i mean by not working

 ![image](https://us1.discourse-cdn.com/flex020/uploads/makecode/original/1X/5a1cbfb49e069721b2609b5149c666e8cd3796a3.png)

---

<div class="post-metadata">

**Author:** ![peli](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/peli/32/12_2.png) [@peli](https://forum.makecode.com/u/peli)\
**Post date:** [March 24, 2020, 2:50pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/13 "2020-03-24T14:50:31Z")

</div>

I’ll take a look today and also look at generating a link with beta included.

---

<div class="post-metadata">

**Author:** ![peli](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/peli/32/12_2.png) [@peli](https://forum.makecode.com/u/peli)\
**Post date:** [March 24, 2020, 8:23pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/14 "2020-03-24T20:23:24Z")

</div>

The problem seems to happen when one is signed in with github. The tutorial loads correctly after signing out. Investigating.

---

<div class="post-metadata">

**Author:** ![peli](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/peli/32/12_2.png) [@peli](https://forum.makecode.com/u/peli)\
**Post date:** [March 25, 2020, 3:33am UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/15 "2020-03-25T03:33:14Z")

</div>

We’ve pushed a fix to beta. You might have to reset your editor to make it work (make sure you save all your scripts).

We used to prefer using the github token if available. We’ve changed to always try the github proxy and bail out to using the token if failed. To avoid caching issues, I would strongly recommend to create releases of your repo. MakeCode will pick the latest release.

---

<div class="post-metadata">

**Author:** ![mickfuzz](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/mickfuzz/32/419_2.png) [@mickfuzz](https://forum.makecode.com/u/mickfuzz)\
**Post date:** [March 25, 2020, 3:43pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/16 "2020-03-25T15:43:31Z")

</div>

Hi there, that makes a lot of sense - I got the impression that I was “trying too hard” somehow - like a watched kettle never boils - and that kind of explains it.

---

<div class="post-metadata">

**Author:** ![mickfuzz](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/mickfuzz/32/419_2.png) [@mickfuzz](https://forum.makecode.com/u/mickfuzz)\
**Post date:** [June 9, 2020, 11:54am UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/17 "2020-06-09T11:54:02Z")

</div>

Hi there,

Sorry to bring this thread up again.  
I managed to get stable links for some time but I’ve returned to them this week and they are not longer working.

Part One

> **[Microsoft MakeCode Arcade](https://arcade.makecode.com/beta#tutorial:github:mickfuzz/makecode-platformer-101/tutorialPartTwo)**
>
> Develop your programming skills by quickly creating and modding retro arcade games with Blocks and JavaScript in the MakeCode editor

Part Two

> **[Microsoft MakeCode Arcade](https://arcade.makecode.com/beta#tutorial:github:mickfuzz/makecode-platformer-101/tutorialPartTwo)**
>
> Develop your programming skills by quickly creating and modding retro arcade games with Blocks and JavaScript in the MakeCode editor

I’m hoping to use these links for an online session early next week so any help is really appreciated.

Thanks  
Mick

---

<div class="post-metadata">

**Author:** ![peli](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/peli/32/12_2.png) [@peli](https://forum.makecode.com/u/peli)\
**Post date:** [June 9, 2020, 2:29pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/18 "2020-06-09T14:29:18Z")

</div>

Where are your tutorial sources?

---

<div class="post-metadata">

**Author:** ![peli](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/peli/32/12_2.png) [@peli](https://forum.makecode.com/u/peli)\
**Post date:** [June 9, 2020, 2:32pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/19 "2020-06-09T14:32:20Z")

</div>

Make sure to create releases ?that have a compliant semver syntax) tog et changes picked up. Our GitHub view in MakeCode does that.

MakeCode now uses the content of the latest release, not HEAD to load the tutorial source.

---

<div class="post-metadata">

**Author:** ![mickfuzz](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/mickfuzz/32/419_2.png) [@mickfuzz](https://forum.makecode.com/u/mickfuzz)\
**Post date:** [June 13, 2020, 2:03pm UTC](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355/20 "2020-06-13T14:03:03Z")

</div>

Thanks!

I think a problem was I had all my course material in one repo. So updates were causing problems.  
I’ve separated off the Make Code tutorial parts from the others and should be all good from now on.

**Part one**  
[https://arcade.makecode.com/beta#tutorial:https://github.com/mickfuzz/mca\_platformer\_tutorial/tutorialPartOne](https://arcade.makecode.com/beta#tutorial:https://github.com/mickfuzz/mca_platformer_tutorial/tutorialPartOne)

**Part Two**  
[https://arcade.makecode.com/beta#tutorial:https://github.com/mickfuzz/mca\_platformer\_tutorial/tutorialPartTwo](https://arcade.makecode.com/beta#tutorial:https://github.com/mickfuzz/mca_platformer_tutorial/tutorialPartTwo)

[Next page](https://forum.makecode.com/t/review-requested-on-a-platformer-tutorial-and-start-of-a-set-of-course-resourses/1355.md?page=2)