email example, fix requirement for lists, add description/keywords
add line for using Asciidoctor HEAD [ci skip]