update header docs a bit