improve headings, add warning about :warn