Docs changes based on Melih's tech review comments