cleanup doc link
add non-fatal warning assertions