ynput / ayon-documentation

Documentation of Ayon
Creative Commons Attribution Share Alike 4.0 International
4 stars 13 forks source link

System Settings Tools - add highlighted note on how tools are set per folder #84

Open BigRoy opened 10 months ago

BigRoy commented 10 months ago

Issue

New users often don't understand how Tool groups work - they think adding a tool to the list is sufficient but they need to actually be assigning the tool to existing folders explicitly (and potentially update the project's default if they want that tool available for new folders).

Additional context

Came up on discord here

Are you stuck now?

You have registered a tool but it's not available on launch in the application?

Go here:

  1. AYON Web App -> Projects -> [select a project] -> Editor
  2. Here you see "folders" (whose type may be "asset", "folder", etc...).
  3. Select the one you are interested in
  4. Look on the right panel : there is a "Tool" combobox (dropdown) that lets you select a tool (for example VRay).

Or create another hierarchy of folders, so that they immediately get the Tool you set in the template for that project.

tools_on_folder

Directions from here

mkolar commented 9 months ago

they think adding a tool to the list is sufficient but they need to actually be assigning the tool to existing folders explicitly (and potentially update the project's default if they want that tool available for new folders).

This is the important bit. That the first destination should be adding the new tools to project defaults. tools attribute inherits from parents by default, so in vast majority of cases that is enough to propagate the new tool. In OpenPype this was an issue, but AYON's inheritable attributes are solving it quite well. Of course it's a different matter if it's clear enough that you need to add it to the project. We'll have a look at that point in the docs and emphasize it.

Thanks