devops: cleaned up writing and added tldr