updating documentation for recent-ish changes