Update Hiero artist documentation with new publisher.

website/docs/addon_hiero_artist.md

@@ -97,17 +97,19 @@ This tool will set any defined colorspace definition from AYON `Settings / Proje
 
 <div class="row markdown">
 
-With AYON, you can use Hiero/NKS as a starting point for creating a project's **shots** as *assets* from timeline clips with its *hierarchycal parents* like **episodes**, **sequences**, **folders**, and its child **tasks**. Most importantly it will create **versions** of plate *products*, with or without **reference video**. Publishig is naturally creating clip's **thumbnails** and assigns it to shot *asset*. Hiero is also publishing **audio** *product* and various **soft-effects** either as retiming component as part of published plates or **color-tranformations**, that will be evailable later on for compositor artists to use either as *viewport input-process* or *loaded nodes* in graph editor.
+With AYON, you can use Hiero/Nuke Studio as a starting point for creating a project's **shots** as *assets* from timeline clips with its *hierarchycal parents* like **episodes**, **sequences**, **folders**, and its child **tasks**. Most importantly it will create **versions** of plate *products*, with or without **reference video**. Publishig is naturally creating clip's **thumbnails** and assigns it to shot *asset*. Hiero also supports publishing **audio** *product* and various **soft-effects** either as retiming component part of published plates or **color-tranformations**. Those will be available later on for compositor artists to use either as *viewport input-process* or *loaded nodes* in the graph editor.
 <br></br><br></br>
 
 <iframe width="512px" height="288px" src="https://www.youtube.com/embed/mdIfbTY5fCc" frameborder="0" modestbranding="1" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen="1"></iframe>
 
-### Preparing timeline for conversion to instances
-Because we don't support on-fly data conversion so in case of working with raw camera sources or some other formats which need to be converted for 2D/3D work. We suggest to convert those before and reconform the timeline. Before any clips in timeline could be converted to publishable instances we recommend following.
-1. Merge all tracks which supposed to be one and they are multiply only because of editor's style
-2. Rename tracks to follow basic structure > if only one layer then `main` in case of multiple layer (elements) for one shot then `main`, and other elements for example: `bg`, `greenscreen`, `fg01`, `fg02`, `display01`, etc. please avoid using [-/_.,%&*] or spaces. These names will be later used in *product* name creation as `{family}{trackName}` so for example **plateMain** or **plateFg01**
+### Preparing a timeline for publishing shot, plates and more
+Data conversion is not part of the process, so when working with raw camera sources or other formats which need to be converted for 2D/3D work, we recommend to convert those first and use those in the timeline. Before any clips in timeline could be converted to publishable instances we recommend following.
+1. Reduce track amount by merging all tracks that can be one
+2. Rename tracks to follow basic structure. Please avoid using `[-/_.,%&*]` or spaces. These names will be later used in *product* name creation as `{family}{trackName}` so for example **plateMain** or **plateFg01** 
+	> if only one track it can be `main`
+	> when dealing with multiple layers (elements) for one shot then use `main` and other elements for example: `bg`, `greenscreen`, `fg01`, `fg02`, `display01`, etc. 
 3. Define correct `Set Media Color Transform` at all clips as those will be also published to metadata and used for later loading with correct color transformation.
-4. Reviewable video material which you wish to be used as preview videos on any supported Projec manager platform (Ftrack) has to be added ideally to track named **review**. This can be offline edit used as reference video for 2D/3D artists. This video material can be edited to fit length of **main** timeline track or it cand be one long video clip under all clips in **main** track, because AYON will trim this to appropriate length with use of FFMPEG. Please be avare we only support MP4(h264) or JPG sequence at the moment.
+4. Additional reviewable video material which you wish to be used as preview videos on any supported Project manager platform (Ftrack) has to be added ideally to track named **review**. This can be offline edit used as reference video for 2D/3D artists. This video material can be edited to fit length of **main** timeline track or it can be one long video clip under all clips in **main** track, because AYON will trim this to appropriate length with use of FFMPEG. Please be aware we only support MP4(h264) or JPG sequence at the moment.
 
 <div class="col--6 markdown">
 
@@ -122,7 +124,7 @@ Every clip on timeline which is intended to be published has to be converted to
 
 <div class="col col--6 markdown">
 
-In AYON it is done by tagging a clip with our own metadata. Select all clips you wish to convert and `menu > AYON > Create`.
+In AYON it is done by tagging a clip with our own metadata. Select all clips you wish to convert then `menu > AYON > Create`.
 <br></br><br></br>
 
 </div>
@@ -135,16 +137,7 @@ In AYON it is done by tagging a clip with our own metadata. Select all clips you
 
 <div class="col col--6 markdown">
 
-Then chose `Create Publishable Clip` in **Instance Creator** dialogue.
-<br></br>
-
-Then you can alter Product name, but this will be changed dynamically and replaces with timeline's track name.
-<br></br>
-
-Keep **Use selection** on.
-<br></br>
-
-Hit **Create**
+Then chose `Create Publishable Clip` in **Creator** editor.
 <br></br>
 </div>
 
@@ -155,10 +148,12 @@ Hit **Create**
 </div>
 <div class="col col--6 markdown">
 
-Dialogue `Pype publish attributes creator` will open. Here you can define instance properties. If you wish to rename clips dynamically during creation then Keep  **Rename clips** ticked.
+In the create options, you can define instances' properties.
+You might want to let `use only selected clip(s)` to only mark current selection as publishable clips.
+If you wish to rename clips dynamically during creation then Keep  **Rename clips** ticked.
 <br></br>
 
-In case you wish to use *multiple elements of shots* workflow then keep **Enamble vertical sync** ticked on and define correct hero track which is holding main plates, this is usually the **main** track.
+In case you wish to use *multiple elements of shots* workflow then ensure **Enable vertical sync** is ticked on and choose the correct hero track which is holding main plates, this is usually the **main** track.
 </div>
 
 <div class="col col--6 markdown">
@@ -171,13 +166,13 @@ In case you wish to use *multiple elements of shots* workflow then keep **Enambl
 Product name is created dynamically if `<track_name>` is selected on **Product name**.
 <br></br>
 
-I case you wish to publish reviewable video as explained above then find the appropriate track from drop down menu **Use review track**. Usually named `review`
+In case you wish to publish reviewable video as explained above, then find the appropriate track from drop down menu **Use review track**. Usually named `review`
 <br></br>
 
 Hover above each input field for help.
 <br></br>
 
-Handles can be defined here to. In case you wish to have individual clip set differently we recommend to set here the default value and later change those in the created AYON tag's metadata under `handleStart` and `handleEnd` properties (look below for details)
+Handles can be defined here too. In order to have individual clip set differently we recommend to set here a default value and change those later in the created AYON shot instances under `handleStart` and `handleEnd` properties (look below for details).
 </div>
 
 <div class="col col--6 markdown">
@@ -187,10 +182,13 @@ Handles can be defined here to. In case you wish to have individual clip set dif
 </div>
 <div class="col col--6 markdown">
 
-After you hit **Ok** tags are added to selected clips (except clips in **review** tracks).
+After you hit **Create** new instances get added in the "Products to publish section". Also custom AYON tags are added to selected clips (except clips in **review** tracks).
 <br></br>
 
-If you wish to change any individual properties of the shot then you are able to do it here. In this example we can change `handleStart` and `handleEnd` to some other values.
+If you wish to change any individual properties of the shot then you are able to do it directly on the instance under the `Publish` widget. In this example we can change `handleStart` and `handleEnd` to some other values.
+
+<br></br>
+Action the **Publish** button to trigger the publishing process for the active instances.
 </div>
 
 <div class="col col--6 markdown">
@@ -271,4 +269,4 @@ This tool can be used to check if some instances were published after the last b
 
 :::note
 Imported instances must not be deleted because they contain extra attributes that will be used to update the workfile since the place holder is been deleted.
-:::
+:::