From 5dc854c75e1735fb906640963dcaea462000f4c9 Mon Sep 17 00:00:00 2001
From: Kynan Ware <47394200+BagToad@users.noreply.github.com>
Date: Wed, 14 May 2025 11:50:11 -0600
Subject: [PATCH] doc(issue edit): clarify synchronous handling of assignees

---
 pkg/cmd/pr/shared/editable_http.go | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/pkg/cmd/pr/shared/editable_http.go b/pkg/cmd/pr/shared/editable_http.go
index 465bfda6c..cd183e565 100644
--- a/pkg/cmd/pr/shared/editable_http.go
+++ b/pkg/cmd/pr/shared/editable_http.go
@@ -62,6 +62,10 @@ func UpdateIssue(httpClient *http.Client, repo ghrepo.Interface, id string, isPR
 		wg.Go(func() error {
 			// updateIssue mutation does not support Actors so assignment needs to
 			// be in a separate request when our assignees are Actors.
+			// Note: this is intentionally done synchronously with updating
+			// other issue fields to ensure consistency with how legacy
+			// user assignees are handled.
+			// https://github.com/cli/cli/pull/10960#discussion_r2086725348
 			if options.Assignees.Edited && options.Assignees.ActorAssignees {
 				apiClient := api.NewClientFromHTTP(httpClient)
 				assigneeIds, err := options.AssigneeIds(apiClient, repo)