making a doc block more clear