doc updates and motivation