update readme with links and notes