Thanks guys. I'm still struggling, as I find there are many alternative ways of doing things, which overlap and aren't easy to distinguish (yotta/mbed/js/DAL/HAL/ubit etc.etc.) when all I want is a simple way of extending a basic C prog like Hello World, to access other peripherals using the mbed compiler. I want something fast (so I can measure short time intervals). C with a high level library, compiled, seems perfect.

I think for the benefit of those wanting to transition to microbit from other platforms, who want to use a fast compiled system rather than an interpreted one, and who just want it to work rather than go on a learning odyssey, you could make a simple tutorial. At the moment there seems to be a lot of almost trivial intro stuff, and then links straight into github or elsewhere with no explanation and no middle ground.

I would like to have (and therefore I guess others would too), something that started with say Hello World but then rather than basically saying "get on with it" and sending you somewhere else, just expanded that example with reference info to the other calls. Then we could expand our programs progressively and soon get into the swing of these tools. Instead, we have ..

Starting from https://developer.mbed.org/platforms/Microbit/, the mbed microbit page says: "Lancaster University have prepared *full documentation* and a *getting started guide* ". Both links get you to the same place: https://lancaster-university.github.io/microbit-docs/online-toolchains/ (the former via an online development tools link). Then you get another Hello World example, and for more info, a link to " Lancaster-University team wiki on mbed" . Then you get "Access Denied"!

The github links don't seem to include a library reference guide.

So where is the ubit reference that explains ubit.display.scroll(" ") and all the other calls in the ubit library in one document? With that I think I can produce stuff quickly.

Having written in most programming languages over many years, but most recently developing simple automation using Picaxe, I do appreciate how hard it can be to document complex things in a simple form, but also how good it can be when it is done well. If every Year 7 in the UK has a microbit, you can be sure some of them are soon going to push the boundaries beyond what they have already done at primary school. At my Code Club they learn Scratch, html, and python and some Picaxe code, so compiled C/C++ isn't much of a stretch for the most able.

cheers

Stuart

Thanks, this is useful feedback and we'll look at trying to make the flows clear. I've just been through and done a few things:

• Made the Lancaster University team public instead of private to fix the 'Access Denied'
• Changed the 'Full Documentation' link on the platform page to a 'Full API Documentation' link - which now goes to https://lancaster-university.github.io/microbit-docs/ubit/ (which is what I think you were looking for?)
• Made the examples far more obvious on the micro:bit team page: https://developer.mbed.org/teams/microbit/

I think we should probably use that as the main page when linking back to mbed from the Lancaster docs, rather than the Lancaster University team wiki page - I'll talk to the Lancaster team about what they'd prefer.

Finally - I think the library reference you were looking for can be found by the top navigation bars on the github docs site. Is that all rendering right for you? For example click on the 'uBit' menu to see the other components? like https://lancaster-university.github.io/microbit-docs/ubit/serial/ or https://lancaster-university.github.io/microbit-docs/ubit/io/

I hope those changes help!