Примеры удобных комментариев из Swift

//
// MARK: Section mark
//

//
// TODO: Do something soon
//

//
// FIXME: Fix this code
//

/**
    A greet operation

    - A bullet in docs
    - Another bullet in the docs

    :param: name - a name
    :param: day - a day
    :returns: a string containing the name and day value.
*/
function greet (name, day)  {
    return 'Hello ' + name + ', today is ' + day + '.';
}

var groceries = {
      squash: 2
    , applese: 8
    // # ifdef PARTY_TIME
    , hardCider: 12
    , munchies: 2
    // #endif
};