rewrite core doc
rephrase heading for clarity