URI docs and updated index

Yes, however you want to get those points across (clearly not as I wrote them).