En este video aprenderemos a documentar adecuadamente nuestro código utilizando una interesante funcionalidad incorporada por Apple en Xcode 7, como es la capacidad para escribir comentarios de código utilizando el lenguaje de marcado ligero Markdown, y una serie de palabras reservadas que dejaran nuestros comentarios relucientes.
Holaaa, no se como usar caracteres ascii en Xcode, pls help meeeee 🙁
Hola una pregunta, donde puedes ver todas las palabras reservadas que comentas en tu vídeo?
Gracias!!
Hola Ainhoa,
Tienes toda la info aquí por ejemplo:
https://developer.apple.com/library/content/documentation/Xcode/Reference/xcode_markup_formatting_ref/
Un saludo.
Excelente video Miguel 😀
Les dejo un enlace a los que quieran leer mas del tema.
http://nshipster.com/swift-documentation/
Os paso el enlace de un libro muy bueno sobre el tema, escrito por Erica Sadun, titulado «Swift Documentation Markup». https://itunes.apple.com/es/book/swift-documentation-markup/id1049010423?mt=11
Muy importante el tema de la documentación y frecuentemente olvidado. Por si a alguien le resulta útil, el paquete VVDocumenter de Alcatraz hace un poco rápido el proceso extrayendo automáticamente todos los parámetros.
https://github.com/onevcat/VVDocumenter-Xcode
Gracias por el video y mucha suerte en esta nueva andadura!.
Gracias por tu comentario Alberto! Y gran enlace el que nos incluyes, da para un video incluso! ¿te animas? ;·)
Vaya, no había visto tu respuesta Miguel. Venía a comentar que por desgracia lo que dije ya no es posible desde la salida del XCode 8. Hasta que Apple no permita firmar los plugins o se pueda hacer algo similar con las nuevas Xcode Extensions, me temo que por ahora nos quedamos sin Alcatraz y sin plugins como el VVDocumenter 🙁
De todos modos me apunto la idea del vídeo por si sale otro tema interesante 🙂