Reorder and freshen up the documentation on model specs a bit