few improvements to the model doc