Los comentarios de documentación de FLIN usan el prefijo ///. Se adjuntan a la declaración que los sigue inmediatamente y son elementos de primera clase del AST, capturados durante el análisis sintáctico, preservados durante el formateo y disponibles para generación automática de documentación. La separación entre // y /// representa una diferencia fundamental de intención: los comentarios regulares son notas para el desarrollador actual; los comentarios de documentación son un contrato con todos los futuros desarrolladores.
Esta es la Parte 175 de la serie "Cómo construimos FLIN", que documenta cómo un CEO en Abidjan y un CTO de IA diseñaron y construyeron un lenguaje de programación desde cero.
Navegación de la serie: - [174] Pruebas, benchmarks y fuzzing - [175] Comentarios de documentación en FLIN (estás aquí) - [176] Demo integrado y plantillas