improve header documentation