Documentación de ayuda rápida generada automáticamente por Xcode 8

Entre las nuevas funciones anunciadas en Xcode 8 , podemos ver

"Generar automáticamente documentación de ayuda rápida":

¿Es este el final de la documentación del código manual como podemos aprender en este artículo de NSHipster ?

¿Alguien puede describir los pros y los contras de esta nueva función? ¿Reemplaza herramientas como Jazzy ?

No pude encontrar más información sobre la nueva función.

Esto se refiere a la función Xcode 8 (y posterior), donde puede seleccionar un método como este:

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

... y luego presione ⌘+ option+ /(o elija “Estructura” »“ Agregar documentación ”del menú“ Editor ”de Xcode) y generará la siguiente plantilla de comentarios para usted:

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

Simplemente facilita la redacción de documentación para la Ayuda rápida.

Tenga en cuenta que, aunque este comportamiento ha cambiado un poco con el tiempo, Xcode puede ser particular sobre dónde debe estar el cursor cuando intenta hacer esto. Por ejemplo, el cursor tiene que estar en algún lugar del nombre de la función, fooen mi ejemplo anterior, para que esto funcione. O simplemente haga doble clic en el nombre de la función y luego presione ⌘+ option+/

Lo más probable es que esto esté relacionado con el hecho de que TODAS las teclas de acceso rápido con '/' no funcionan en la versión actual de XCode 8, si su teclado requiere presionar Mayús para obtenerlo.

Es decir, en el teclado alemán, la '/' es shift + 7, presionar alt + cmd + shift-7 no hace nada. Si asigna, por ejemplo, cmd + shift + opt + d, funciona bien.

El acceso directo '///', que lamentablemente tampoco funciona en este momento, probablemente se deba al antiguo complemento de XCode VVDocumenter, que utilizaba exactamente este acceso directo.

Gran característica, pésimo control de calidad en el lado de Apple.