<\/p>\n\n\n\n
Con los a\u00f1os dej\u00e9 de ver la documentaci\u00f3n de un Design System como un entregable. Empec\u00e9 a verla como la forma de conservar el contexto detr\u00e1s de las decisiones \u2014 para que el producto siga evolucionando aunque cambien las personas.<\/p>\n\n\n\n
Durante mucho tiempo pens\u00e9 que documentar un Design System era una tarea que pod\u00eda esperar.<\/p>\n\n\n\n
Cuando el proyecto iba justo de tiempo, siempre hab\u00eda algo m\u00e1s urgente: terminar componentes, corregir bugs, preparar una entrega o avanzar con nuevas funcionalidades. La documentaci\u00f3n terminaba qued\u00e1ndose para \u201cdespu\u00e9s\u201d.<\/p>\n\n\n\n
Con el tiempo entend\u00ed que el problema no era posponer documentaci\u00f3n.<\/p>\n\n\n\n
Era posponer decisiones.<\/p>\n\n\n\n
Porque cuando una decisi\u00f3n no queda registrada, tarde o temprano alguien tiene que volver a tomarla. Y normalmente lo hace sin conocer el contexto original.<\/p>\n\n\n\n
\u00daltimamente se habla mucho de Agentic Design Systems<\/em> y de c\u00f3mo la IA necesita documentaci\u00f3n para entender un sistema.<\/p>\n\n\n\n Es cierto.<\/p>\n\n\n\n Pero creo que esa conversaci\u00f3n empieza desde el lugar equivocado.<\/p>\n\n\n\n La documentaci\u00f3n nunca fue importante porque la necesitara una inteligencia artificial. Siempre fue importante porque la necesitamos nosotros.<\/p>\n\n\n\n Lo que cambi\u00f3 es que ahora la IA nos obliga a enfrentar algo que antes pod\u00edamos ignorar: todas esas reglas que nunca escribimos porque \u201ctodo el equipo ya las conoce\u201d.<\/p>\n\n\n\n Hasta que alguien nuevo llega. O alguien se va.<\/p>\n\n\n\n Y entonces descubrimos que muchas decisiones nunca estuvieron realmente documentadas. Solo estaban en la cabeza de alguien.<\/p>\n\n\n\n Hay algo que me gusta recordar cada vez que trabajo con un Design System.<\/p>\n\n\n\n No es una librer\u00eda. No son los componentes. No son los tokens. No es Figma. Ni siquiera es el c\u00f3digo.<\/p>\n\n\n\n Todo eso son herramientas.<\/p>\n\n\n\n El verdadero Design System son las decisiones que viven detr\u00e1s de cada una de ellas.<\/p>\n<\/blockquote>\n\n\n\n Y las decisiones cambian constantemente. Nuevos productos, nuevas necesidades del negocio, nuevas tecnolog\u00edas\u2026 todo hace que el sistema evolucione.<\/p>\n\n\n\n Por eso nunca he visto un Design System \u201cterminado\u201d. Y, honestamente, creo que tampoco deber\u00eda existir esa expectativa.<\/p>\n\n\n\n Hace poco le\u00ed una idea que me hizo mucho sentido:<\/p>\n\n\n\n La IA no necesita un Design System perfecto. Necesita uno honesto.<\/p>\n<\/blockquote>\n\n\n\n Mientras m\u00e1s lo pienso, m\u00e1s creo que eso tambi\u00e9n aplica para las personas.<\/p>\n\n\n\n Imagina que ma\u00f1ana llega un dise\u00f1ador o un desarrollador senior a tu equipo. Tiene experiencia. Aprende r\u00e1pido. Pero no conoce tu producto.<\/p>\n\n\n\n \u00bfCu\u00e1nto podr\u00eda entender \u00fanicamente leyendo la documentaci\u00f3n?<\/p>\n\n\n\n Si necesita preguntar absolutamente todo, probablemente el problema no sea la persona nueva. Es que muchas decisiones nunca quedaron registradas.<\/p>\n\n\n\n No pasa nada si existen excepciones o inconsistencias. Todos los sistemas las tienen. Lo importante es conocerlas y hacerlas visibles.<\/p>\n\n\n\n Porque trabajar con un sistema imperfecto pero transparente siempre ser\u00e1 mejor que trabajar con uno que aparenta estar completo.<\/p>\n\n\n\n Durante a\u00f1os hab\u00eda una raz\u00f3n v\u00e1lida para no documentar. Era costoso. Dif\u00edcil de mantener. Y muchas veces quedaba desactualizado pocas semanas despu\u00e9s de escribirlo.<\/p>\n\n\n\n Pero eso tambi\u00e9n est\u00e1 cambiando.<\/p>\n\n\n\n Hoy existen herramientas capaces de generar documentaci\u00f3n desde el c\u00f3digo, sincronizar cambios autom\u00e1ticamente e incluso ayudar a construir documentaci\u00f3n con apoyo de IA.<\/p>\n\n\n\n Eso no significa que el trabajo desaparezca. Significa que el esfuerzo ya no est\u00e1 en escribir todo desde cero.<\/p>\n\n\n\n Ahora podemos dedicar m\u00e1s tiempo a lo realmente importante: dejar claras las decisiones.<\/p>\n\n\n\n Con los a\u00f1os cambi\u00e9 la forma en la que veo la documentaci\u00f3n. Ya no la considero un entregable.<\/p>\n\n\n\n La veo como una conversaci\u00f3n que el equipo deja disponible para quienes llegan despu\u00e9s.<\/p>\n\n\n\n Es el lugar donde una decisi\u00f3n deja de depender de la memoria de una persona y pasa a formar parte del conocimiento colectivo.<\/p>\n\n\n\n Y quiz\u00e1 eso sea lo m\u00e1s valioso de un Design System. No los componentes. No los tokens. Ni siquiera las herramientas.<\/p>\n\n\n\n Sino la capacidad de conservar el contexto detr\u00e1s de las decisiones para que el producto pueda seguir evolucionando, incluso cuando cambian las personas.<\/p>\n\n\n\n Porque al final, los sistemas cambian. La tecnolog\u00eda cambia. Los equipos cambian.<\/p>\n\n\n\n Pero las buenas decisiones merecen permanecer un poco m\u00e1s.<\/p>\n\n\n\n Creo que ese es el verdadero prop\u00f3sito de documentar. No llenar p\u00e1ginas. No cumplir un checklist. Sino asegurarnos de que el conocimiento pueda seguir creciendo sin depender de qui\u00e9n estuvo ah\u00ed para tomar la primera decisi\u00f3n.<\/p>\n\n\n\n <\/p>\n","protected":false},"excerpt":{"rendered":" Con los a\u00f1os dej\u00e9 de ver la documentaci\u00f3n de un Design System como un entregable. Empec\u00e9 a verla como la\u2026<\/p>\n","protected":false},"author":1,"featured_media":11,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"pagelayer_contact_templates":[],"_pagelayer_content":"","footnotes":""},"categories":[4,5,6],"tags":[17,11,15,14,16],"class_list":["post-9","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-design-system","category-documentacion","category-ux-ui","tag-decisiones","tag-diseno","tag-diseno-ux-ui","tag-documentacion","tag-ux"],"_links":{"self":[{"href":"https:\/\/nadiagh.com\/blog\/wp-json\/wp\/v2\/posts\/9","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nadiagh.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/nadiagh.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/nadiagh.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/nadiagh.com\/blog\/wp-json\/wp\/v2\/comments?post=9"}],"version-history":[{"count":2,"href":"https:\/\/nadiagh.com\/blog\/wp-json\/wp\/v2\/posts\/9\/revisions"}],"predecessor-version":[{"id":30,"href":"https:\/\/nadiagh.com\/blog\/wp-json\/wp\/v2\/posts\/9\/revisions\/30"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/nadiagh.com\/blog\/wp-json\/wp\/v2\/media\/11"}],"wp:attachment":[{"href":"https:\/\/nadiagh.com\/blog\/wp-json\/wp\/v2\/media?parent=9"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/nadiagh.com\/blog\/wp-json\/wp\/v2\/categories?post=9"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/nadiagh.com\/blog\/wp-json\/wp\/v2\/tags?post=9"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Un Design System nunca est\u00e1 terminado<\/h2>\n\n\n\n
\n
La documentaci\u00f3n no tiene que ser perfecta<\/h2>\n\n\n\n
\n
Hoy documentar cuesta mucho menos<\/h2>\n\n\n\n
Al final, documentar es compartir conocimiento<\/h2>\n\n\n\n