Documentation

Documentation

Documentation for a Swift declaration.

public struct Documentation: Hashable, Codable

Inheritance

Codable, Hashable

Properties

summary

The summary.

var summary: String?

discussionParts

The text segments and callouts that comprise the discussion, if any.

var discussionParts: [DiscussionPart] = []

parameters

The documented parameters.

var parameters: [Parameter] = []

returns

The documented return value.

var returns: String?

`throws`

The documented error throwing behavior.

var `throws`: String?

isEmpty

Whether the documentation has any content.

var isEmpty: Bool

Methods

parse(_:)

Create and return documentation from Swift Markup text.

public static func parse(_ text: String?) throws -> Documentation

• Parameters

  • text: The documentation text in Swift Markup (CommonMark) format.

Throws

• CommonMark.Document.Error if the provided text can't be parsed.

Returns

A structured representation of the documentation.