documentation fixes
add diagnostic
update release tests