Put some comments in places we get asked about a lot

Change-Id: If932b82f4e225cfdda21f47e4215c6f4c59dae4a