Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Editing the docs

To edit micro:bit documentation, please edit the raw markdown files contained in the ./docs folder. Please note that any text placed inside a block like this:

[comment]: <> ({"className":"MicroBitAccelerometer"}) 

[comment]: <> ({"end":"MicroBitAccelerometer"})

Will be deleted and regenerated when python is executed.

We use mkdocs version 0.15.3 to build this site, please use this version only.

mkdocs can be obtained via the pip command.

Live editing

It is recommended that docs are edited locally using mkdocs serve before submitting a pull request with changes.

Generating API documentation

Text placed in the following markdown comments:

[comment]: <> ({"className":"MicroBitAccelerometer"}) 

[comment]: <> ({"end":"MicroBitAccelerometer"})

Is automatically generated by the script. Any changes made here will not be retained. Changes to API documentation should be made at the source: either microbit-dal or microbit.

Only maintainers of this repository are allowed to push updates to the live site.

Building the docs

To build the docs run the python script with the paths to microbit and microbit-dal as parameters.

python2.7 -m ../lancasteruni/microbit -d ../lancasteruni/microbit-dal

The variable runtime must be manually changed in mkdocs.yml to match the the version of the DAL that is in use.


Old versions of the site are contained in the archive folder:


and can be accessed using the specific version tag:

Links to the archived versions are manually added to the /help/ page.


To upload the docs to run the python script python2.7 -g

This will upload to the origin's gh-pages branch