link to newer version
add notes and assertion