Skip to content

Commit

Permalink
comment additions, thanks
Browse files Browse the repository at this point in the history
  • Loading branch information
ganicke committed Apr 30, 2024
1 parent 47eed42 commit 5e1e9b0
Show file tree
Hide file tree
Showing 2 changed files with 27 additions and 2 deletions.
2 changes: 1 addition & 1 deletion docs/writing-docs/tutorials/resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -179,7 +179,7 @@ my_asset_pack=github:my_github_username/my_asset_pack
```
````

**Important**: Make sure that the name on the left hand side of the "=" matches the name of your extension from Step 1.
**Important**: Make sure that the name on the left hand side of the "=" matches the name of your extension from Step 1. However, if the asset pack's repository name contains "-" such as `github:my_github_username/my-asset-pack`, the name on the left of the "=" should replace the "-" characters with spaces such that `my-asset-pack` becomes `myassetpack`.

Now, instead of including the background image in your code snippets, you can reference it like so:

Expand Down
27 changes: 26 additions & 1 deletion docs/writing-docs/tutorials/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,4 +22,29 @@ Tutorial markdown files are required to be less than **128K** bytes.

### Asset packs in MakeCode Arcade

There can be several images and/or very large images within the asset sections or instructions of a tutorial markdown file. Often these will make the tutorial file size exceed the 128K byte limit. You can reduce the size of the tutorial file by moving the images into a separate asset pack. See the instructions in the [resources](/writing-docs/tutorials/resources) page for creating an [asset pack](/writing-docs/tutorials/resources#creating-asset-packs).
There can be several images and/or very large images within the asset sections or instructions of a tutorial markdown file. Often these will make the tutorial file size exceed the 128K byte limit. You can reduce the size of the tutorial file by moving the images into a separate asset pack. See the instructions in the [resources](/writing-docs/tutorials/resources) page for creating an [asset pack](/writing-docs/tutorials/resources#creating-asset-packs).

## Tutorial game screen just shows activity spinner

If activity indicator on the game screen in the tutorial seems to just spin and never load, there's probably an error. Start by opening the JavaScript console and try to re-run the tutorial. It should give you an idea of what's causing it to not work.

## Kind types aren't working in MakeCode Arcade

If you added a "kind" and MakeCode generated the code for you, it won't work correctly in the tutorial. You need to add `//% isKind` before each declaration.

The kind that was declared in your tutorial code, such as:

```typescript
namespace SpriteKind {
export const Veggies = SpriteKind.create()
}
```

You should add `//% isKind` to the declaration:

```typescript
namespace SpriteKind {
//% isKind
export const Veggies = SpriteKind.create()
}
```

0 comments on commit 5e1e9b0

Please sign in to comment.