updated documentation blocks