better docs w/lynn