improving blocks and updating docs