Extend method description

Author: vicentepinto98

services/iaasalpha/wait/wait.go

@@ -178,7 +178,15 @@ func DeleteServerWaitHandler(ctx context.Context, a APIClientInterface, projectI
 }
 
 // ProjectRequestWaitHandler will wait for a request to succeed
-// It receives a request id that can be obtained from the x-request-id header in the http response of any operation in the IaaS API
+// It receives a request id that can be obtained from the x-request-id header in the http response of any operation in the IaaS API.
+// To get the raw http response of an operation using the SDK, use the runtime.WithCaptureHTTPResponse method from the core pkg.
+// Then the value of the request id can be obtained by accessing the header key which is defined in the constant XRequestIDHeader in this package.
+// Example usage:
+// 	var httpResp *http.Response
+// 	ctxWithHTTPResp := runtime.WithCaptureHTTPResponse(context.Background(), &httpResp)
+// 	err = iaasalphaClient.AddPublicIpToServer(ctxWithHTTPResp, projectId, serverId, publicIpId).Execute()
+// 	requestId := httpResp.Header[wait.XRequestIDHeader][0]
+// _, err = wait.ProjectRequestWaitHandler(context.Background(), iaasalphaClient, projectId, requestId).WaitWithContext(context.Background())
 func ProjectRequestWaitHandler(ctx context.Context, a APIClientInterface, projectId, requestId string) *wait.AsyncActionHandler[iaasalpha.Request] {
 	handler := wait.New(func() (waitFinished bool, response *iaasalpha.Request, err error) {
 		request, err := a.GetProjectRequestExecute(ctx, projectId, requestId)