# Lacking documentation

**URL:** https://forum.makecode.com/t/lacking-documentation/5740
**Category:** PXT
**Created:** [January 25, 2021, 6:18pm UTC](https://forum.makecode.com/t/lacking-documentation/5740 "2021-01-25T18:18:00Z")
**Posts on this page:** 3
**Page:** 1

<div class="post-metadata">

### Author: ![ychamare](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/ychamare/32/2929_2.png) [@ychamare](https://forum.makecode.com/u/ychamare)
#### Post date: [January 25, 2021, 6:18pm UTC](https://forum.makecode.com/t/lacking-documentation/5740/1 "2021-01-25T18:18:00Z")

</div>

I believe the Documentation is very vague and not helpful t all, is this all you need to do, not really right??

### Adding a JavaScript library to your target

There are many useful JavaScript libraries that you might want to use in your target, especially to make it easier to build the simulator ( `sim/simulator.js` ). The basic pattern to do this is:

- add the JavaScript file(s) to the directory `sim/public/js`
- include these files in `sim/public/simulator.html` using the `<script>` tag

---

<div class="post-metadata">

### Author: ![jfo8000](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/jfo8000/32/1038_2.png) [@jfo8000](https://forum.makecode.com/u/jfo8000)
#### Post date: [January 27, 2021, 4:13pm UTC](https://forum.makecode.com/t/lacking-documentation/5740/2 "2021-01-27T16:13:15Z")

</div>

Yeah the docs do tend to spin you in circles a bit - have faith the information is there - it’s just hard to take in all at once. I started from pxt-sample and worked my way slowly from there.

So yes, you do have a simulator which is your own sandboxed-iframe-land in which you can display whatever you want. This api is called a Board.

The blocks are executed (api.ts) and you make calls onto your board to do stuff. I haven’t done the electronics bit so my knowledge sortof ends there in terms of compiling for devices.

I found the best was to look at the labs and look at other pxts. You can tend to chart my progression by looking at [https://github.com/Buildbee/makecode/commits/master](https://github.com/Buildbee/makecode/commits/master)

The other thing it took me a while to work out was that there are a lot of settings for your website stuffed into the pxtarget.json file, and it’s worthwhile sitting down and comparing the various targets to see and understand what to use.

---

<div class="post-metadata">

### Author: ![voltron\_force](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/voltron_force/32/3179_2.png) [@voltron\_force](https://forum.makecode.com/u/voltron_force)
#### Post date: [January 27, 2021, 6:34pm UTC](https://forum.makecode.com/t/lacking-documentation/5740/3 "2021-01-27T18:34:45Z")

</div>

hi @ychamare