doc updates from Alex