better docs for framework class definition