Estaba leyendo sobre una herramienta de código abierto @Dusk diseñada para detectar documentación que, silenciosamente, dejó de estar de acuerdo con el código. Así que, naturalmente, probé la idea en el objetivo más conveniente disponible: los propios documentos de Dusk.
La herramienta se llama Pituitary. Tiene licencia MIT, es un solo binario, no usa Docker y no requiere claves de API. Indexa tus especificaciones, documentos y registros de decisiones, y luego marca decisiones superpuestas, documentación obsoleta, código que contradice la especificación, cambios en la terminología y la cadena de impacto cuando una especificación cambia. Además, incluye un servidor MCP, para que un agente de IA de programación tenga conciencia de la especificación en medio de la sesión en lugar de construir con confianza sobre una decisión que se revirtió hace meses. Un equipo de blockchain que construye infraestructura general para desarrolladores y la entrega bajo MIT no es algo que vea a menudo. Reconocimiento donde corresponde.
Luego leí los documentos. El registro de Network Updates de Dusk afirma, sin rodeos, que las nuevas transacciones de Phoenix se rechazan en mainnet después del reinicio de Boreas, y que Moonlight es el modelo de transacción soportado a partir de ahora. La página que aprende sobre Transaction Models todavía describe Phoenix en tiempo presente, como una de dos maneras nativas de que el valor se mueve en DuskDS, y concluye diciéndote que eres libre de elegir entre ambas. No se menciona la desactivación en la página.
Desviación de especificación “tipo libro de texto”, que está en la documentación del equipo que envió el detector de desviaciones.
Con justicia, la documentación se queda atrás de la realidad en cualquier cadena. Lo que hace que Dusk sea inusual es que publica un registro preciso y con fuentes de su hard-fork, y es la única razón por la que la brecha es visible para mí. La cuestión no es que hayan fallado. Es que incluso un equipo que construyó el detector no puede evitar del todo el problema.
Entonces, ¿qué documentación confías realmente para una cadena: las páginas de aprendizaje, el changelog o el código fuente? ¿Y qué haces cuando los tres no coinciden?
#dusk $DUSK
La herramienta se llama Pituitary. Tiene licencia MIT, es un solo binario, no usa Docker y no requiere claves de API. Indexa tus especificaciones, documentos y registros de decisiones, y luego marca decisiones superpuestas, documentación obsoleta, código que contradice la especificación, cambios en la terminología y la cadena de impacto cuando una especificación cambia. Además, incluye un servidor MCP, para que un agente de IA de programación tenga conciencia de la especificación en medio de la sesión en lugar de construir con confianza sobre una decisión que se revirtió hace meses. Un equipo de blockchain que construye infraestructura general para desarrolladores y la entrega bajo MIT no es algo que vea a menudo. Reconocimiento donde corresponde.
Luego leí los documentos. El registro de Network Updates de Dusk afirma, sin rodeos, que las nuevas transacciones de Phoenix se rechazan en mainnet después del reinicio de Boreas, y que Moonlight es el modelo de transacción soportado a partir de ahora. La página que aprende sobre Transaction Models todavía describe Phoenix en tiempo presente, como una de dos maneras nativas de que el valor se mueve en DuskDS, y concluye diciéndote que eres libre de elegir entre ambas. No se menciona la desactivación en la página.
Desviación de especificación “tipo libro de texto”, que está en la documentación del equipo que envió el detector de desviaciones.
Con justicia, la documentación se queda atrás de la realidad en cualquier cadena. Lo que hace que Dusk sea inusual es que publica un registro preciso y con fuentes de su hard-fork, y es la única razón por la que la brecha es visible para mí. La cuestión no es que hayan fallado. Es que incluso un equipo que construyó el detector no puede evitar del todo el problema.
Entonces, ¿qué documentación confías realmente para una cadena: las páginas de aprendizaje, el changelog o el código fuente? ¿Y qué haces cuando los tres no coinciden?
#dusk $DUSK