Merge branch '28607-forking-and-configuring-project-via-api-works-very-unreliable' into 'master'

Confirm Project forking behaviour via the API

Closes #28607

See merge request !11931

changelogs/unreleased/28607-forking-and-configuring-project-via-api-works-very-unreliable.yml

+---
+title: Confirm Project forking behaviour via the API
+merge_request:
+author:

doc/api/projects.md

@@ -415,6 +415,8 @@ Parameters:
 
 Forks a project into the user namespace of the authenticated user or the one provided.
 
+The forking operation for a project is asynchronous and is completed in a background job. The request will return immediately. To determine whether the fork of the project has completed, query the `import_status` for the new project.
+
 ```
 POST /projects/:id/fork
 ```