Documentazione di guida rapida generata automaticamente da Xcode 8

Tra le nuove funzionalità annunciate in Xcode 8 , possiamo vedere

"Genera automaticamente documentazione della Guida rapida":

È questa la fine della documentazione del codice manuale come possiamo imparare in questo articolo da NSHipster ?

Qualcuno può delineare i pro ei contro di questa nuova funzionalità? Sostituisce strumenti come Jazzy ?

Non sono riuscito a trovare ulteriori informazioni sulla nuova funzione.

Questo si riferisce alla funzionalità Xcode 8 (e successive), in cui è possibile selezionare un metodo come questo:

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

... e poi premi ⌘+ option+ /(o scegli "Struttura" »" Aggiungi documentazione "dal menu" Editor "di Xcode) e genererà il seguente modello di commenti per te:

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

Facilita solo la scrittura della documentazione per la Guida rapida.

Nota, sebbene questo comportamento sia leggermente cambiato nel tempo, Xcode può essere particolare su dove deve essere il cursore quando si tenta di farlo. Ad esempio, il cursore deve trovarsi da qualche parte nel nome della funzione, foonel mio esempio precedente, affinché funzioni. Oppure fai doppio clic sul nome della funzione e quindi premi ⌘+ option+/

Ciò è molto probabilmente correlato al fatto che TUTTI i tasti di scelta rapida con un '/' non funzionano nell'attuale build di XCode 8, se la tua tastiera richiede di premere Shift per ottenerlo.

Cioè sulla tastiera tedesca la "/" è shift + 7, premere alt + cmd + shift-7 non fa nulla. Se assegni ie cmd + shift + opt + d, funziona bene.

La scorciatoia "///", che purtroppo anche al momento non funziona, è probabilmente dovuta al vecchio plugin XCode VVDocumenter, che utilizzava esattamente questa scorciatoia.

Grande funzionalità, pessimo controllo di qualità sul lato Apple.