URI docs and updated index

I can change it to _ratings_, because you want that, but not because I agree.