headers doco

fixes #300