# Making a Custom Reference Page

**URL:** <https://forum.makecode.com/t/making-a-custom-reference-page/42226>\
**Category:** Arcade\
**Created:** [February 18, 2026, 6:49am UTC](https://forum.makecode.com/t/making-a-custom-reference-page/42226 "2026-02-18T06:49:20Z")\
**Posts on this page:** 11\
**Page:** 1

<div class="post-metadata">

**Author:** ![BLADEr](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/blader/32/16422_2.png) [@BLADEr](https://forum.makecode.com/u/BLADEr)\
**Post date:** [February 18, 2026, 6:49am UTC](https://forum.makecode.com/t/making-a-custom-reference-page/42226/1 "2026-02-18T06:49:20Z")

</div>

I am currently trying to fine tune my softbody extension and was wondering how I could make my own reference page for it. Something like this, [Reference Page](https://arcade.makecode.com/reference/animation/run-image-animation)

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

Can someone please shed some light on this? Thanks!

---

<div class="post-metadata">

**Author:** ![TheEarth](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/theearth/32/34579_2.png) [@TheEarth](https://forum.makecode.com/u/TheEarth)\
**Post date:** [February 18, 2026, 10:56pm UTC](https://forum.makecode.com/t/making-a-custom-reference-page/42226/2 "2026-02-18T22:56:18Z")

</div>

the frames are image arrays and thats all i know

---

<div class="post-metadata">

**Author:** ![redSprite](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/redsprite/32/34262_2.png) [@redSprite](https://forum.makecode.com/u/redSprite)\
**Post date:** [February 19, 2026, 7:06pm UTC](https://forum.makecode.com/t/making-a-custom-reference-page/42226/3 "2026-02-19T19:06:24Z")

</div>

Inspecting the page on github we get this:

 ![image](https://us1.discourse-cdn.com/flex020/uploads/makecode/original/3X/6/d/6d3ce36b14f83d0a70eeaf106fd888482cce9bb1.png)  
Try that maybe? It’s what is for showing the block I’m assuming.

---

<div class="post-metadata">

**Author:** ![WoofWoof](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/woofwoof/32/32523_2.png) [@WoofWoof](https://forum.makecode.com/u/WoofWoof)\
**Post date:** [February 19, 2026, 7:06pm UTC](https://forum.makecode.com/t/making-a-custom-reference-page/42226/4 "2026-02-19T19:06:36Z")

</div>

Look at other extensions! They link to references with something like //% help=… and the help pages are in the GitHub repos. For example, in Richard’s arcade-mini-menu extension, the block definition for the Close Menu block has this “help=” line here:

 ![Screenshot 2026-02-19 at 10.53.28 AM](https://us1.discourse-cdn.com/flex020/uploads/makecode/original/3X/5/d/5db1664014cbb47287cafd6ffc4190d844e23c0b.png)  
And that links to this file in the GitHub Repo:

> <https://github.com/riknoll/arcade-mini-menu/blob/master/docs/close.md>

@richard your help page is a little broken. Is there a way to fix that? Look:

 ![Screenshot 2026-02-19 at 10.57.24 AM](https://us1.discourse-cdn.com/flex020/uploads/makecode/original/3X/a/c/acb2957108ac44fb042f901d3d2786a914b0f9a5.png)  
This is the one for the Close Menu block.

---

<div class="post-metadata">

**Author:** ![richard](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/richard/32/5417_2.png) [@richard](https://forum.makecode.com/u/richard)\
**Post date:** [February 19, 2026, 7:09pm UTC](https://forum.makecode.com/t/making-a-custom-reference-page/42226/5 "2026-02-19T19:09:21Z")

</div>

oh, i must have missed that snippet when i was doing the find/replace after my last update to the extension.

@BLADEr i wrote up some detailed instructions on how to add docs a while back:

> **[Adding documentation for GitHub extensions](https://makecode.com/extensions/github-docs)**
>
> Extensions hosted on GitHub can include help pages for blocks/APIs they export. A user can open the help page for a block by right-clicking on it in the editor and selecting “Help”.

---

<div class="post-metadata">

**Author:** ![BLADEr](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/blader/32/16422_2.png) [@BLADEr](https://forum.makecode.com/u/BLADEr)\
**Post date:** [February 19, 2026, 7:41pm UTC](https://forum.makecode.com/t/making-a-custom-reference-page/42226/6 "2026-02-19T19:41:53Z")

</div>

Thank you guys so much! This will really help

Is there a way I can mark this topic “Solved”? or is that someone else’s job?

---

<div class="post-metadata">

**Author:** ![WoofWoof](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/woofwoof/32/32523_2.png) [@WoofWoof](https://forum.makecode.com/u/WoofWoof)\
**Post date:** [February 19, 2026, 9:28pm UTC](https://forum.makecode.com/t/making-a-custom-reference-page/42226/7 "2026-02-19T21:28:31Z")

</div>

It seems that the solved feature is only enabled for topics with the game jam tag. It’s really weird! @richard is there a reason for this?

---

<div class="post-metadata">

**Author:** ![richard](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/richard/32/5417_2.png) [@richard](https://forum.makecode.com/u/richard)\
**Post date:** [February 19, 2026, 10:01pm UTC](https://forum.makecode.com/t/making-a-custom-reference-page/42226/8 "2026-02-19T22:01:52Z")

</div>

i have no idea, but i don’t really want that feature enabled since most of our topics aren’t really questions… maybe i could do it for just the help category

---

<div class="post-metadata">

**Author:** ![WoofWoof](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/woofwoof/32/32523_2.png) [@WoofWoof](https://forum.makecode.com/u/WoofWoof)\
**Post date:** [February 19, 2026, 11:21pm UTC](https://forum.makecode.com/t/making-a-custom-reference-page/42226/9 "2026-02-19T23:21:52Z")

</div>

I think most people are bothered because that one badge for solving a topic is _almost_ unattainable. So either having it turned on for help topics or off for game jam topics would solve the issue. Personally having it on for help topics feels like a better solution - because I want the badge of course! 😛 - but also because it will hopefully be easier to tell when someone is satisfied with an answer.

---

<div class="post-metadata">

**Author:** ![BLADEr](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/blader/32/16422_2.png) [@BLADEr](https://forum.makecode.com/u/BLADEr)\
**Post date:** [February 19, 2026, 11:21pm UTC](https://forum.makecode.com/t/making-a-custom-reference-page/42226/10 "2026-02-19T23:21:57Z")

</div>

I’m still fairly new to github and don’t know how to navigate it to its fullest. Are there any videos out there that could help me make this documentation page? I’m sorry that I have no idea what I’m doing! I appreciate all of your help.

---

<div class="post-metadata">

**Author:** ![BLADEr](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/blader/32/16422_2.png) [@BLADEr](https://forum.makecode.com/u/BLADEr)\
**Post date:** [February 19, 2026, 11:29pm UTC](https://forum.makecode.com/t/making-a-custom-reference-page/42226/11 "2026-02-19T23:29:20Z")

</div>

I think so too
