Sort schema and update docs

[finnagin]

Also I don't have write access so I think my review doesn't count toward being able to merge this. You may need to add one more person to look at it @patrickkwang .