KAA-229: add and normalize header documentation