doc block updates