How to create documentation of your swift Code

Updated 26 December 2019


Documenting your code is an important part of development. Code documentation regards a structured way to write comments using special keywords, also named tags, and marking the comments area with special characters, so the compiler perfectly understands it. Many developers overlook or ignore the importance of the code documentation, and that’s really bad, as good software is not just good code. It’s more than that. So today  I am going to show different ways of creating documentation of your code.

With the introduction of Xcode 7, developers can use the powerful Markdown syntax to apply rich text formatting to the text of their documentation. Proper code documentation enables you to produce complete HTML documentation for your app using various tools, such as the HeaderDoc and Doxygen.


There are 2 ways to create comments in swift

  1. Single Line Comment (\\).
  2. Multi-Line Comment (/* ... */).


Documentation comments look like normal comments, but they come with some extra features. You can write documentation comments in 2 ways:

  1. Single-line documentation comments have three slashes (\\).
  2. Multi-line documentation comments have an extra star in their opening delimiter (/** ... */).

Below is an example of how to create a basic documentation comment.

Swift provides many ways to auto-generate documentation structure for your code.

  1. Press  Command + Option + / inside the and it will automatically create a structure for your documentation.
  2. Select Method go to Editor menu then structure and select Add Documentation


In Objective-C, the pre-processor directive #pragma mark  is used to divide functionality into meaningful, easy-to-navigate sections. In Swift, there are no pre-processor directives, but the same can be accomplished with the comment // MARK:


Standard Markdown rules apply inside documentation comments.

The leading paragraph of a documentation comment becomes the documentation Summary. Any additional content is grouped together into the Discussion section.

Xcode recognizes a few special fields and makes them separate from a symbol’s description. Below is the list of these fields:

Parameters & Return Values

The parameters, return value and throws sections are broken out in the Quick Help pop over and inspector when styled as a bulleted item followed by a colon (:).

Below I have attached the sample of proper documentation of code looks like.

Thank you


. . .

Leave a Comment

Your email address will not be published. Required fields are marked*

Be the first to comment.

Start a Project

    Message Sent!

    If you have more details or questions, you can reply to the received confirmation email.

    Back to Home