Make use of new callback step for external provisioning

Interaction with LSO is now completely reworked. More efficient, more faster, more better, more prettier, and will make us all rich

Depends on lso!51 (merged)

gso/services/provisioning_proxy.py

@@ -4,15 +4,15 @@
 """
 import json
 import logging
+from functools import partial
 
 import requests
-from functools import partial
 from orchestrator import step
 from orchestrator.config.assignee import Assignee
 from orchestrator.types import State, UUIDstr, strEnum
 from orchestrator.utils.errors import ProcessFailureError
 from orchestrator.utils.json import json_dumps
-from orchestrator.workflow import Step, callback_step, begin, StepList, inputstep
+from orchestrator.workflow import Step, StepList, begin, callback_step, inputstep
 from pydantic_forms.core import FormPage, ReadOnlyField
 from pydantic_forms.types import FormGenerator
 from pydantic_forms.validators import LongText
@@ -285,8 +285,11 @@ def _show_pp_results(state: State) -> FormGenerator:
 
 
 def pp_interaction(provisioning_step: Step) -> StepList:
-    """
-    An interaction with the provisioning proxy :term:`LSO` as a callback step.
+    """Interact with the provisioning proxy :term:`LSO` using a callback step.
+
+    An asynchronous interaction with the provisioning proxy. This is an external system that executes Ansible playbooks
+    in order to provision service subscriptions. If the playbook fails, this step will also fail, allowing for the user
+    to retry provisioning from the UI.
 
     :param provisioning_step: A workflow step that performs an operation remotely using the provisioning proxy.
     :type provisioning_step: :class:`Step`