doc: correct file header
doc: reorganize and improve consistency on configuration primitives