Correcting a bunch of incorrect documentation for the different API services and resources. (#494)

internal/proto/local/controller/api/resources/authmethods/v1/auth_method.proto

@@ -33,7 +33,8 @@ message AuthMethod {
 	// Output only. The time this resource was last updated.
 	google.protobuf.Timestamp updated_time = 70 [json_name="updated_time"];
 
-	// Version can be used in subsequent write requests to ensure this resource has not changed and to fail the write if it has.
+	// Version is used in mutation requests, after the initial creation, to ensure this resource has not changed.
+  // The mutation will fail if the version does not match the latest known good version.
 	uint32 version = 80;
 
 	// The Auth Method type.