documenting heading parameter