include local deps
minor doc fix regarding best practices
cleanup comments