The introduction of the SINK and SOURCE mode to beginners can be confusing and also unnecessary, since DigitalOut defaults to SINK mode anyways.
Recommendation: in the example code and the documentation, instead of this:
#include <Plaquette.h>
DigitalOut led(13, SINK);
Do this:
#include <Plaquette.h>
DigitalOut led(13);
//it is possible to operate the DigitalOut in SOURCE mode, for example if you are powering a common anode RGB LED
//DigitalOut led(13, SOURCE);
Another suggestion is to replace the potentially confusing terms of SINK and SOURCE with terms like DIRECT and INVERTED.
For the online documentation http://sofapirate.github.io/Plaquette/DigitalOut.html
The introduction of the SINK and SOURCE mode to beginners can be confusing and also unnecessary, since DigitalOut defaults to SINK mode anyways.
Recommendation: in the example code and the documentation, instead of this:
Do this:
Another suggestion is to replace the potentially confusing terms of SINK and SOURCE with terms like DIRECT and INVERTED.