Updating best practices to fit markdown