Key APIs and DSLs should be documented properly. The recommendation is to use Apple docstrings. In the near future(Xcode 13 and later) we could be able to switch to DocC