Close gh-197

Documentation update for model behaviours