The first iteration of adding USD docs

[MustafaJafar]

Changelog Description

Adding USD Docs.

• Create a feature card for USD addon
• Add Artist Docs
  • USD Intro
  • Get Started
  • Contribution Workflow
  • Maya Workflow
  • Houdini Workflow
  • Blender Workflow ? (No clients asked for it as far as I know)
  • FAQ
• Add Admin Docs
• Give the Docs a last review

Additional info

First drafts of the docs exists here AYON USD Workflow Guide

Testing notes:

1. start with this step
2. follow this step

[MustafaJafar]

How it looks like currently:

[MustafaJafar]

Here's how badges added in this commit 0b4e51f look

[BigRoy]

Ah, looking nice.

[BigRoy]

🕐 Deadline!

We're looking to get this into a solid basic state for USD documentation by this Friday to be able to merge it as a 'first pass' on USD documentation. It'd be good to go over it and review it as if this is all the usd knowledge one may have for AYON with USD. So please fill in where you see gaps that are crucial for a that 0.1 release of AYON USD docs.

[BigRoy]

@MustafaJafar and @LiborBatek thanks for the help 🥳 💪

Massive work for a first iteration. There are still miles to go to make the docs better and more detailed, but there's also still a lot down to improving the tools themselves too.

This is a great starter guide for some edge cases that may arise and things to watch out for. Far from perfect but gets the Approved stamp from me for a first iteration. 🚀 ✅

Do another proof-read @MustafaJafar and feel free to merge.

[LiborBatek]

Even tho its already approved, I would like to add a few notes...

First, great work @BigRoy and @MustafaJafar ...it is much clearer for understanding (maybe because I have practised a bit with USD in maya too :)

It would be lovely to add a section to the Contribution Workflow how this works with usdAsset and usdShot and AYON folder context...as if Im not mistaken thats the root aka target prim to contribute too. At least thats what I think...simply the context from which you are about to make a contribution decides the target prim to contribute to e.g. character or shot 100. Its just small bit of info missing to me. So as the user stays in the proper context, the automatic contribution workflow will take care of the root prim and writes (contribute) to correct hierarchy...

It could be just short info plus hierarchy example (those "code block" styled ones) not anything long text wise.

Other than missing bits (shot workflow, animation, lookdev workflow in maya parts) looks good! Thanks again!

[LiborBatek]

LGTM!

[MustafaJafar]

It would be lovely to add a section to the Contribution Workflow how this works with usdAsset and usdShot and AYON folder context...as if Im not mistaken thats the root aka target prim to contribute too. At least thats what I think...simply the context from which you are about to make a contribution decides the target prim to contribute to e.g. character or shot 100. Its just small bit of info missing to me. So as the user stays in the proper context, the automatic contribution workflow will take care of the root prim and writes (contribute) to correct hierarchy...

It could be just short info plus hierarchy example (those "code block" styled ones) not anything long text wise.

@LiborBatek
I have added something similar which lives in FAQ section.
http://localhost:3000/docs/addon_usd_artist_faq#what-are-all-these-publisher-options-like-target-product
could you tell me if that what you are looking for ?

[MustafaJafar]

Well, it's not bad for a first iteration. let's merge it!
And there's always room for improvements.