1 tiny improvement to this already great post, you can use the documentation feature of Xcode /// which allows you to add useful annotations which can be found here
developer.apple.com/documentation/xcode/formattin…
DocC is also applicable when documentation is used inside an package project