Swift API Design Guidelines

It's really clever how they have an official variation of Markdown as the official comment documentation format.

To help with documentation, install VVDocumenter: <a href="https:&#x2F;&#x2F;github.com&#x2F;onevcat&#x2F;VVDocumenter-Xcode" rel="nofollow">https:&#x2F;&#x2F;github.com&#x2F;onevcat&#x2F;VVDocumenter-Xcode</a><p>I&#x27;ve changed my trigger from &quot;&#x2F;&#x2F;&#x2F;&quot; to &quot;&#x2F;&#x2F;&#x2F;&#x2F;&quot; so that I can write &quot;&#x2F;&#x2F;&#x2F;&quot; comments manually if I want to.<p>-----<p>Some things I might add:<p>- If possible, use a protocol as the base for all functionality. Generally, this is named &quot;FooType&quot;.<p>- If you provide a &quot;FooType&quot;, provide a type-erased &quot;AnyFoo&quot; as well.

This website renders pretty crappy on an iPad.