updated the block documentation