Models docfixes

#1044 equivalent (there must be a more efficient way to do this, without opening a new PR)

rebased and  resolved conflicts
@keflavich ready to merge?