add precaution to annotated docs
add source links
fix source link
update stuff