add a bit more explanation to the core_model