fix a few minor code smells
add a very short tutorial