How to use Swift documentation comments

\n For those who want to add this as code snippet. Swift 5, XCode 11.3+\n\n\nThis is an add on to : Yogendra Singh's Answer in this thread\n\n/**\n<#Summay text for documentation#>\n\n- parameter <#parameterName#>: <#Description#>.\n- returns: <#Return values#>\n- warning: <#Warning if any#>\n\n\n # Notes: #\n 1. <#Notes if any#>\n\n # Example #\n```\n // <#Example code if any#>\n```\n\n*/\n\n\n\n Copy and paste the above code in Xcode. Select the code and then Right click.\n\n\n\n\n\n Save the code snippet and give the completion name as documentation.\n\n\n\n\n\n Now if we start typing documentation, the snippet will be shown in the code completion.\n\n\n",

Use the following notation for documentation comments.\n\n/**\n This method sum two double numbers and returns.\n\n Here is the discussion. This methods adds two double and return the optional Double.\n\n\n - parameter number1: First Double Number.\n - parameter number2: Second Double Number.\n - returns: The sum of two double numbers.\n\n # Notes: #\n 1. Parameters must be **double** type\n 2. Handle return type because it is optional.\n\n # Example #\n```\n if let sum = self.add(number1: 23, number2: 34) {\n print(sum)\n }\n ```\n*/\n\n\nfunc add(number1: Double, number2: Double) -> Double? {\n return number1 + number2\n}\n\n\n",

Keyboard shortcut in Xcode\noption + cmd + /\n",

This answer was last revised for Swift 5.7 and Xcode 14.x.\n\nDocC is Apple's documentation compiler that takes comments (plus additional resources) and produces rich documentation that can be viewed in Xcode or hosted on web.\nWriting Documentation\nType /// or /** */ to begin a documentation comment and then use DocC's special dialect of Markdown to write the content. This dialect supports many keywords like - Parameters: for describing function arguments or - Returns: for describing return values.\nNote how the > Warning: keyword was recognized as an aside and automatically emphasized. DocC supports multiple other aside types like Note, Tip and Important.\n/// Produce a greeting string for the given `subject`.\n///\n/// ```\n/// print(hello("world")) // "Hello, world!"\n/// ```\n///\n/// > Warning: The returned greeting is not localized. To\n/// > produce a localized string, use ``localizedHello(_:)``\n/// > instead.\n///\n/// - Parameters:\n/// - subject: The subject to be welcomed.\n///\n/// - Returns: A greeting for the given `subject`.\nfunc hello(_ subject: String) -> String {\n return "Hello, \\(subject)!"\n}\n\n\nLinking to Symbols\nDocC will automatically link (and auto-complete!) symbols wrapped in double backticks ``. You can link to related symbols in the same type or other types in the same module.\nNote that linking is limited only to public symbols and only to one module. As of today, there's no way to type e.g. ``UIView`` and have DocC automatically link it to UIKit's documentation.\nGenerating Webpages\nDocC supports exporting your documentation into webpages. First, you need to compile your documentation by choosing Product → Build Documentation. Once the documentation is built, export its archive by clicking the More button. The archive will contain the entire documentation webpage that you can then host on your server.\nThe above process is a bit complicated, so there are many tools that can help you automate it. Apple offers swift-docc-plugin that you can add to your Swift package or Xcode project and configure it to run on every build. You can automate this process on CI as well.\nFurther Reading\nI recommend reading the following guides to learn more about DocC:\n\nWriting Symbol Documentation in Your Source Files\nFormatting Your Documentation Content\nAdding Structure to Your Documentation Pages\nDistributing Documentation to External Developers\n",

Xcode 7.0 beta 4\n\nThe notation has been changed (:param: does not work anymore ...)\n\n/// Creates the string representation of the poo with requested size.\n///\n/// - warning: Be carefull! Poos can hurt.\n/// - parameter size: requested size of the poo\n/// - returns: string representation of the poo\nfunc makePoo(size: String) -> String\n{\n return \"Ouch. This is \\(size) poo!\"\n}\n\n\nAnd it looks like this:\n\n\n\nYou can use either /// or /** */",