• I find the docs very "all over the place" and uninviting

    The search bar on espruino.com is definitely your friend. I wish we could do better but there's a lot of information to get across for a lot of different boards, and not all of it is directly related to functions (like jQuery/etc).

    If you do find things that could be improved it'd be great if you could issue a PR or at least give a prod. Especially on http://www.espruino.com/Reference if you want to update docs for a function, click the character after the function's title - it'll bring you to the area of code where the documentation for the function is, and it's easy enough to tweak it there :)

    and if I want to be certain to starts and connects to the IDE, I need to restart my Mac.

    aha - have you seen this: http://www.espruino.com/Puck.js#i-can-t-reconnect-to-my-puck-js-on-mac-os

    The issue seems to be that Puck.js can't handle multiple connections, so doesn't advertise when it's connected. If you've set it up as a BLE HID device then the Mac automatically connects, and so stops the Web IDE from connecting too :) I think Google might be fixing it in a Chrome update (so chrome shows you devices you're already connected to) but I doubt it's hit mainstream yet.

    Also, if you haven't updated your firmware yet then the firmware Puck.js ships with can be a bit hit and miss to connect to on some devices as well.

About

Avatar for Gordon @Gordon started