Documentação de ajuda rápida gerada automaticamente pelo Xcode 8

Entre os novos recursos anunciados no Xcode 8 , podemos ver

"Gerar documentação de ajuda rápida automaticamente":

Este é o fim da documentação do código manual como podemos aprender neste artigo do NSHipster ?

Alguém pode descrever os prós e os contras desse novo recurso? Ele substitui ferramentas como o Jazzy ?

Não consegui encontrar mais informações sobre o novo recurso.

Isso se refere ao recurso Xcode 8 (e posterior), onde você pode selecionar um método como este:

func foo(bar: Int) -> String { ... }

... e então pressione ⌘+ option+ /(ou escolha “Estrutura” »“ Adicionar documentação ”do menu“ Editor ”do Xcode) e ele irá gerar o seguinte modelo de comentários para você:

/// <#Description#>
///
/// - parameter bar: <#bar description#>
///
/// - returns: <#return value description#>

Isso apenas facilita a redação de documentação para Ajuda Rápida.

Observe que, embora esse comportamento tenha mudado um pouco com o tempo, o Xcode pode ser específico sobre onde o cursor deve estar quando você tenta fazer isso. Por exemplo, o cursor deve estar em algum lugar no nome da função, foono meu exemplo acima, para que isso funcione. Ou apenas clique duas vezes no nome da função e pressione ⌘+ option+/

Isso provavelmente está relacionado ao fato de que TODAS as teclas de atalho com um '/' não funcionam na compilação atual do XCode 8, se o seu teclado exigir que você pressione shift para obtê-lo.

Ou seja, no teclado alemão o '/' é shift + 7, pressionando alt + cmd + shift-7 não faz nada. Se você atribuir, por exemplo, cmd + shift + opt + d, funcionará perfeitamente.

O atalho '///', que infelizmente também não funciona agora, provavelmente se deve ao antigo plugin do XCode VVDocumenter, que usava exatamente esse atalho.

Excelente recurso, péssimo controle de qualidade do lado da Apple.