I’ve been working on an open-source Package to help with SDK integration and realized when testing it out in another project that all of my summary comments have vanished when viewing the Package’s function definitions from the main assembly (regular project scripts). This is a feature within Visual Studio which lets you hover over a type and see developer insight comments next to your mouse cursor. Furthermore, when I use the “peek definition” feature I can see that all comments have been erased.
As you can probably guess from the title, I think this is the result of utilizing an Assembly Definition within my package. I used it because I’ve heard that this is the best practice and in fact this is Unity’s recommended package workflow. I guess it makes sense why the comments would be erased if the main assembly can only see some form of the “compiled” version. However, for a package like the one I’m trying to create where working with the API can be a little complicated (and the provided SDK has comments of its own that are getting scrubbed away) I’d really love to let users see all the notes I’ve written to help them use it more efficiently. Also, I can see the source code files themselves in the “project” window so I’m not sure why Visual Studio is unable to just peek into that for the comments, but maybe this is some weird limitation of the system.
I could try just removing the .asmdef file and letting users just include all of the code into their main assembly, however it would remove one of the benefits of the assembly which is having code that compiles separately from their project. The included SDK is pretty hefty and I don’t want users to have that kind of bloat in their project; it would be a compilation performance hit essentially. So is there any way to preserve the speed gains of the assembly file while still allowing users to see comments in my package? Thanks in advance!