minor doc fixes
add dev warning