fix main docs
docs: tips for debugging and testings
fix docs
notating warnings