core review; refresh docu