documenting ‘heading’ parameter