overhauled .blocks, and added documentation