adding more docs for behavior specs