in-code doc updates