Building the documentation with Xcode 26.0.1 (Swift 6.2) gets 50+ warnings

[thomasvl]

Looks like we've got some issues in our docstrings, building the documentation in Xcode 26 results in a pretty large number of warnings. Some of them impl the IDE popups might be missing info or fail to cross reference correctly.

[thomasvl]

Someone like also should look for all the cases we used a single backtick instead of a double backtick to actually get references linked up correctly.