feat: Improve descriptions and comments

Author: joaopalet

examples/iaasalpha/image/image.go

@@ -55,7 +55,7 @@ func main() {
 	}
 	req.Header.Set("Content-Type", "application/octet-stream")
 
-	fmt.Printf("[iaasalpha API] Uploading image %q...\n", *imageCreateResp.Id)
+	fmt.Printf("[iaasalpha API] Uploading image contents to %q...\n", *imageCreateResp.Id)
 	client := &http.Client{}
 	resp, err := client.Do(req)
 	if err != nil {
@@ -68,10 +68,10 @@ func main() {
 		os.Exit(1)
 	}
 	_ = resp.Body.Close()
-	fmt.Printf("[iaasalpha API] Image %q has been successfully uploaded.\n", *imageCreateResp.Id)
+	fmt.Printf("[iaasalpha API] Image %q has been uploaded.\n", *imageCreateResp.Id)
 
 	// Wait for image to become available
-	image, err := wait.ImageUploadWaitHandler(ctx, iaasalphaClient, projectId, *imageCreateResp.Id).WaitWithContext(ctx)
+	image, err := wait.UploadImageWaitHandler(ctx, iaasalphaClient, projectId, *imageCreateResp.Id).WaitWithContext(ctx)
 	if err != nil {
 		fmt.Fprintf(os.Stderr, "[iaasalpha API] Error when waiting for upload: %v\n", err)
 		os.Exit(1)

services/iaasalpha/wait/wait.go

@@ -350,8 +350,8 @@ func DeleteVirtualIPWaitHandler(ctx context.Context, a APIClientInterface, proje
 	return handler
 }
 
-// ImageUploadWaitHandler will wait for server creation
-func ImageUploadWaitHandler(ctx context.Context, a APIClientInterface, projectId, imageId string) *wait.AsyncActionHandler[iaasalpha.Image] {
+// UploadImageWaitHandler will wait for the status image to become AVAILABLE, which indicates the upload of the image has been completed successfully
+func UploadImageWaitHandler(ctx context.Context, a APIClientInterface, projectId, imageId string) *wait.AsyncActionHandler[iaasalpha.Image] {
 	handler := wait.New(func() (waitFinished bool, response *iaasalpha.Image, err error) {
 		image, err := a.GetImageExecute(ctx, projectId, imageId)
 		if err != nil {
@@ -368,7 +368,7 @@ func ImageUploadWaitHandler(ctx context.Context, a APIClientInterface, projectId
 		}
 		return false, image, nil
 	})
-	handler.SetTimeout(15 * time.Minute)
+	handler.SetTimeout(45 * time.Minute)
 	return handler
 }
 

services/iaasalpha/wait/wait_test.go

@@ -864,7 +864,7 @@ func TestImageUploadWaitHandler(t *testing.T) {
 				}
 			}
 
-			handler := ImageUploadWaitHandler(context.Background(), apiClient, "pid", "iid")
+			handler := UploadImageWaitHandler(context.Background(), apiClient, "pid", "iid")
 
 			gotRes, err := handler.SetTimeout(10 * time.Millisecond).WaitWithContext(context.Background())