API doc for loadWorkflowMetadataForVersionInfo

code_samples/api/public_php_api/src/Command/WorkflowCommand.php

@@ -63,6 +63,9 @@
             $output->writeln('Moved ' . $content->getName() . ' through transition ' . $transitionName);
         }
 
+        $versionInfo = $content->getVersionInfo();
+        $workflowMetadataByVersion = $this->workflowService->loadWorkflowMetadataForVersionInfo($versionInfo, $workflowName);
+
         return self::SUCCESS;
     }
 }

docs/content_management/workflow/workflow_api.md

@@ -4,7 +4,7 @@
 
 # Workflow API
 
-You can manage [workflows](workflow.md) with PHP API by using `WorkflowServiceInterface`.
+You can manage [workflows](workflow.md) with PHP API by using [`WorkflowServiceInterface`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Workflow-Service-WorkflowServiceInterface.html).
 
 ## Workflow service
 
@@ -22,36 +22,45 @@
 
 ## Getting workflow information
 
-To get information about a specific workflow for a content item, use `WorkflowServiceInterface::loadWorkflowMetadataForContent`:
+To get information about a specific workflow for a content item, use [`WorkflowServiceInterface::loadWorkflowMetadataForContent`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Workflow-Service-WorkflowServiceInterface.html#method_loadWorkflowMetadataForContent):
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/WorkflowCommand.php', 53, 57) =]]
+[[= include_code('code_samples/api/public_php_api/src/Command/WorkflowCommand.php', 54, 58, remove_indent=True) =]]
 ```
 
 !!! tip
 
     `marking`, a term from [Symfony Workflow]([[= symfony_doc =]]/components/workflow.html),
     refers to a state in a workflow.
 
-To get a list of all workflows that can be used for a given content item, use `WorkflowRegistry`:
+If you already have a [`VersionInfo`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-Values-Content-VersionInfo.html) object, 
+use [`WorkflowServiceInterface::loadWorkflowMetadataForVersionInfo`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Workflow-Service-WorkflowServiceInterface.html#method_loadWorkflowMetadataForVersionInfo) to avoid loading the full [`Content`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-Values-Content-Content.html),
+This method is more efficient when iterating over draft versions:
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/WorkflowCommand.php', 47, 48) =]]
+[[= include_code('code_samples/api/public_php_api/src/Command/WorkflowCommand.php', 66, 67, remove_indent=True) =]]
+```
+
+To get a list of all workflows that can be used for a given content item, use [`WorkflowRegistryInterface::getSupportedWorkflows`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Workflow-Registry-WorkflowRegistryInterface.html#method_getSupportedWorkflows):
+
+``` php
+[[= include_code('code_samples/api/public_php_api/src/Command/WorkflowCommand.php', 48, 48, remove_indent=True) =]]
 ```
 
 ## Applying workflow transitions
 
-To place a content item in a workflow, use `WorkflowService::start`:
+To place a content item in a workflow, use [`WorkflowServiceInterface::start`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Workflow-Service-WorkflowServiceInterface.html#method_start):
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/WorkflowCommand.php', 52, 53) =]]
+[[= include_code('code_samples/api/public_php_api/src/Command/WorkflowCommand.php', 53, 53, remove_indent=True) =]]
 ```
 
 To apply a transition to a content item, use `Workflow::apply`.
-Additionally, you can check if the transition is possible for the given object using `WorkflowService::can`:
+Additionally, you can check if the transition is possible for the given object using [`WorkflowServiceInterface::can`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Workflow-Service-WorkflowServiceInterface.html#method_can):
 
 ``` php
-[[= include_file('code_samples/api/public_php_api/src/Command/WorkflowCommand.php', 59, 62) =]]    }
+[[= include_code('code_samples/api/public_php_api/src/Command/WorkflowCommand.php', 61, 62, remove_indent=True) =]]    
+}
 ```
 
 !!! tip