update docstring of core models