Extractor de Docstrings

Características

Extrae documentación de múltiples lenguajes de programación:

• JSDoc: Comentarios de documentación JavaScript y TypeScript
• Docstrings Python: Documentación de funciones y clases con comillas triples
• JavaDoc: Comentarios de documentación Java con etiquetas estándar

Extracción

Extrae metadatos completos de documentación:

• Nombres de funciones/clases: Identificadores de símbolos
• Descripciones: Texto principal de documentación
• Parámetros: Etiquetas @param con nombres, tipos y descripciones
• Valores de retorno: Etiquetas @return o @returns
• Excepciones: Etiquetas @throws, @exception o secciones raises
• Ejemplos: Etiquetas @example o bloques de código de ejemplo
• Números de línea: Ubicación en el código fuente
• Visibilidad: Miembros públicos, privados o protegidos

Análisis

Analiza patrones de documentación comunes:

• JSDoc: /** ... */ con @param, @return, @throws
• Python: """...""" con secciones Args, Returns, Raises
• JavaDoc: /** ... */ con @param, @return, @throws

Índice

Genera un índice de documentación buscadle:

• Nombres de símbolos para búsqueda rápida
• Categorización por tipo (funciones, clases, métodos)
• Métricas de completitud de documentación
• Recuento de ejemplos, parámetros y tipos de retorno