Fixes after Loom API doc review

Maybe it's better if I pull request against Ben's docs pass branch instead of master? So here it is, includes fixes from ellemenno's comments.