Guía de Cortex Docs: una especificación, dos documentos que no deben perder la unidad

Una especificación ficticia y dos ejemplos en papel muestran si valor, unidad y campo vacío conservan su significado.

Fuente: www.producthunt.com
6 de octubre de 2026
2 min

Una sola especificación reduce el mantenimiento duplicado de documentación y referencias de desarrollo, pero dos resultados parecidos no garantizan la misma regla. En septiembre de 2026, Cortex Docs anunció documentación navegable y SDK tipados a partir de especificaciones. Aquí solo se revisa el significado visible, sin código, uso de SDK ni generación real.

Compara cada salida con la misma ficha

La anchura se mide en unidades de cuadrícula. Escribir «0» significa que no ocupa anchura; en blanco indica sin confirmar, no 0. El documento A explica los tres puntos. La referencia B dice «Anchura: número, 0 por defecto» y omite la unidad. Da a dos lectores la misma ficha vacía y una muestra distinta. Pregunta si el blanco equivale a 0 y cuál es la unidad de «2».

A debe responder «sin confirmar, no escribir 0» y «2 unidades de cuadrícula». B omite la unidad y altera el significado del blanco. Quitar el valor por defecto sin añadir la unidad solo corrige la mitad. Verifica por separado la unidad, el cero explícito y el campo vacío. Que ambos se llamen «anchura» no basta. Son ejemplos propios sin interfaces, proyectos ni archivos reales.

Aclara las reglas antes de sumar un entregable

Si el equipo mantiene con frecuencia documentación navegable y referencias de desarrollo, vale comparar la especificación común de Cortex Docs. Para una única página interna, mantener la tabla original es más sencillo. Si faltan unidad o significado del blanco, defínelos primero. Ningún resultado convierte lo indefinido en un hecho. No se evalúan generación, funcionamiento, compatibilidad ni exactitud.

Nota sobre el contenido:Este artículo se basa en información pública y sirve como referencia para comparar y elegir herramientas. Las funciones, los precios y las políticas relacionadas pueden cambiar en cualquier momento; consulta la información oficial más reciente.

Fuente original:www.producthunt.com