Missing documentation: Dynamic dispatch / type conformances

[ccummingsNV]

No description provided.

[cheneym2]

What documentation is needed beyond https://shader-slang.org/docs/compilation-api/#dynamic-dispatch ?

Do we need content in the user guide perhaps?

[mkeshavaNV]

@ccummingsNV - Can you please help answer what exactly you're looking for?

[csyonghe]

I think the documentation that @cheneym2 shared is sufficient. The problem I see is that it is not discoverable from the user-guide tree.

What really should be done here is to unify our docs into a single tree, instead of separated in user-guide, docs/ etc. We are planing to move all of our documentation to readthedocs.io in the next quarter, so this should come naturally as a part of that effort.

[ccummingsNV]

As Yong says, I searched but couldn't find that so I assumed it was undocumented. You hit it doubly, as the main site says that the user guide describes the compilation api, and the user guide does contain that (https://shader-slang.org/slang/user-guide/compiling.html#using-the-compilation-api).

At a minimum, if it's a quick fix, why not update the 'compilation api' section in the user guide with a minimal section that describes what it is, and links to that full documentation for more info?).

[ccummingsNV]

Side note: once we start linking docs together there's an interesting question with things like type-conformances / dynamic dispatch and slangpy/sgl. They are 2 sides of the same coin, and the documentation should at least link together, with examples that show both in tandem.

[bmillsNV]

Moving to @aidanfnv - let's get the docs cleaned up and moved to readthedocs