OP-3909 - updated documentation for AE

website/docs/artist_hosts_aftereffects.md

@@ -38,34 +38,67 @@ In AfterEffects you'll find the tools in the `OpenPype` extension:
 
 You can show the extension panel by going to `Window` > `Extensions` > `OpenPype`.
 
-### Create
-
-When you have created an composition you want to publish, you will need to tag existing composition. To do this open the `Creator` through the extensions `Create` button.
-
-![Creator](assets/aftereffects_creator.png)
-
 Because of current rendering limitations, it is expected that only single composition will be marked for publishing!
 
-After Creator is successfully triggered on selected composition, it will be marked with an icon and its color
-will be changed.
-
-![Highlights](assets/aftereffects_creator_after.png)
-
 ### Publish
 
+When you are ready to share some work, you will need to publish it. This is done by opening the `Publisher` through the `Publish...` button.
+
+There is always instance for workfile created automatically (see 'workfileCompositing' item in `Subsets to publish` column.) This allows to publish (and therefore backup)
+workfile which is used to produce another publishable elements (as `image` and `review` items).
+
+Main publishable item in AfterEffects will be of `render` family. Result of this item (instance) is picture sequence that could be a final delivery product or loaded and used in another DCCs.
+
+First select existing composition and then press `Create >>>` in middle column of `Publisher`.
+
+After this process you should have something like this:
+
+![Highlights](assets/aftereffects_publish_instance.png)
+
+Name of publishable instance (eg. subset name) could be configured with a template in `project_settings/global/tools/creator/subset_name_profiles`.
+(This must be configured by admin who has access to Openpype Settings.)
+
+Trash icon under the list of instances allows to delete any selected `render` instance.
+
+Workfile instance will be automatically recreated though. If you do not want to publish it, use pill toggle on the instance item.
+
+If you would like to modify publishable instance, click on `Publish` tab at the top. This would allow you to change name of publishable
+instances, disable them from publishing, change their task etc.
+
+Publisher allows publishing into different context, just click on any instance, update `Variant`, `Asset` or `Task` in the form in the middle and don't forget to click on the 'Confirm' button.
+
 #### RenderQueue
 
 AE's Render Queue is required for publishing locally or on a farm. Artist needs to configure expected result format (extension, resolution) in the Render Queue in an Output module. Currently its expected to have only single render item and single output module in the Render Queue.
 
 AE might throw some warning windows during publishing locally, so please pay attention to them in a case publishing seems to be stuck in a `Extract Local Render`.
 
-When you are ready to share your work, you will need to publish it. This is done by opening the `Publish` by clicking the corresponding button in the OpenPype Panel.
+#### Repair Validation Issues
 
-![Publish](assets/aftereffects_publish.png) 
+If you would like to run validation rules set by your Studio, click on funnel icon at the bottom right. This will run through all
+enabled instances, you could see more information after clicking on `Details` tab.
 
-This tool will run through checks to make sure the contents you are publishing is correct. Hit the "Play" button to start publishing.
+If there is some issue in validator phase, you will receive something like this:
+![Validation error](assets/aftereffects_publish_failed.png)
 
-You may encounter issues with publishing which will be indicated with red squares. If these issues are within the validation section, then you can fix the issue. If there are issues outside of validation section, please let the OpenPype team know. For More details have a look at the general [Publish](artist_tools.md#publisher) documentation.
+All validators will give some description about what the issue is. You can inspect this by clicking on items in the left column.
+
+If there is an option of automatic repair, there will be `Repair` button on the right. In other case you need to fix the issue manually.
+(By deleting and recreating instance, changing workfile setting etc.)
+
+#### Render instance options
+
+There are currently 2 options of `render` item:
+- Render of farm - allows offload rendering and publishing to Deadline - requires Deadline module being enabled
+- Validate Scene Settings - enables validation plugin which controls setting in DB (or asset control system like Ftrak) and scene itself
+
+![Configuration of render instance](assets/aftereffects_render_instance.png)
+
+#### Buttons on the bottom right are for:
+- `Refresh publishing` - set publishing process to starting position - useful if previous publish failed, or you changed configuration of a publish
+- `Stop/pause publishing` - if you would like to pause publishing process at any time
+- `Validate` - if you would like to run only collecting and validating phases (nothing will be published yet)
+- `Publish` - standard way how to kick off full publishing process
 
 ### Load
 
@@ -102,12 +135,19 @@ You can switch to a previous version of the image or update to the latest.
 ![Loader](assets/photoshop_manage_switch.gif)
 ![Loader](assets/photoshop_manage_update.gif)
 
-### Subset Manager
+#### Support help
+If you would like to ask for help admin or support, you could use any of the three options on the `Note` button on bottom left:
+- `Go to details` - switches into a more detailed list of published instances and plugins.
+- `Copy report` - stash full publishing log to a clipboard
+- `Export report` - save log into a file for sending it via mail or any communication tool
 
-![subset_manager](assets/tools_subset_manager.png)
+If you are able to fix the workfile yourself, use the first button on the right to set the UI to initial state before publish. (Click the `Publish` button to start again.)
 
-All created compositions will be shown in a simple list. If user decides, that this composition shouldn't be
-published after all, right click on that item in the list and select 'Remove instance'
+#### Legacy instances
 
-Removing composition directly in the AE would result to worfile contain phantom metadata which could result in
-errors during publishing!
+All screenshots from Publish are from updated dialog, before publishing was being done by regular `Pyblish` tool.
+New publishing process should be backward compatible, eg. if you have a workfile with instances created in the previous publishing approach, they will be translated automatically and
+could be used right away.
+
+If you hit on unexpected behaviour with old instances, contact support first, then you could try to delete and recreate instances from scratch.
+Nuclear option is to purge workfile metadata in `Window > Metadata > Basic > Label`. This is only for most determined daredevils though!