https://techwriters.org/es/TechWriters localized technical-writing feed.https://techwriters.org/es/articles/accessible-code-examples-and-tables/https://techwriters.org/es/articles/accessible-code-examples-and-tables/Thu, 13 Aug 2026 00:00:00 GMTLa accesibilidad en la documentación no termina con la navegación y el contraste. Los ejemplos de código, las respuestas JSON y las tablas de referencia también deben seguir siendo comprensibles y útiles sin depender solo del color.https://techwriters.org/es/articles/ai-as-editor-not-oracle/https://techwriters.org/es/articles/ai-as-editor-not-oracle/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Usa la IA como editora, no como oráculo, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Usa la IA como editora, no como oráculo» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/ai-fact-checking-for-docs/https://techwriters.org/es/articles/ai-fact-checking-for-docs/Thu, 13 Aug 2026 00:00:00 GMTEl texto generativo puede sonar completo mientras inventa defaults, garantías o citas. Construye la verificación alrededor de fuentes autoritativas, ejemplos ejecutables e incertidumbre explícita. El error peligroso de IA no suele ser mala gramática.https://techwriters.org/es/articles/ai-learned-to-write-documentation/https://techwriters.org/es/articles/ai-learned-to-write-documentation/Thu, 13 Aug 2026 00:00:00 GMTEn tres años, la IA generativa convirtió el primer borrador en una operación barata. La cuestión central ya no es si el modelo puede escribir, sino quién responde por los hechos, la estructura, la revisión, las actualizaciones y la calidad.https://techwriters.org/es/articles/api-examples-that-teach/https://techwriters.org/es/articles/api-examples-that-teach/Thu, 13 Aug 2026 00:00:00 GMTUna petición técnicamente válida no es necesariamente un buen ejemplo. Usa valores realistas y secuencias que revelen el modelo de la API y permitan al developer anticipar el siguiente paso. Un ejemplo obtenido de un schema puede ser sintácticamente correcto y no enseñar nada.https://techwriters.org/es/articles/authentication-docs-that-prevent-support-tickets/https://techwriters.org/es/articles/authentication-docs-that-prevent-support-tickets/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Documentación de autenticación que evita tickets de soporte, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Documentación de autenticación que evita tickets de soporte» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/books-and-guides-for-technical-writers/https://techwriters.org/es/articles/books-and-guides-for-technical-writers/Thu, 13 Aug 2026 00:00:00 GMTUna lista útil ya no es una colección de clásicos. Compara las guías activas de Microsoft, Google, GitHub e IBM, usa Diátaxis para revisar la estructura y convierte cada lectura en un ejercicio concreto.https://techwriters.org/es/articles/choosing-a-docs-generator/https://techwriters.org/es/articles/choosing-a-docs-generator/Thu, 13 Aug 2026 00:00:00 GMTSphinx, MkDocs, Astro y otros generadores optimizan modelos de contenido y equipos distintos. Decide por flujo de autoría, extensibilidad, localización y coste de mantenimiento, no por entusiasmo ante una demo. Una demo puede verse excelente y ser incorrecta para tu documentación.https://techwriters.org/es/articles/choosing-search-for-docs/https://techwriters.org/es/articles/choosing-search-for-docs/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Elegir búsqueda para documentación: empieza por los fallos, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Elegir búsqueda para documentación: empieza por los fallos» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/deliberate-practice-for-docs/https://techwriters.org/es/articles/deliberate-practice-for-docs/Thu, 13 Aug 2026 00:00:00 GMTLeer sobre documentación ayuda, pero la habilidad crece más rápido al repetir ejercicios pequeños de investigación, reestructuración, edición y verificación con feedback claro. “Mejorar en technical writing” es demasiado amplio.https://techwriters.org/es/articles/diagrams-as-code-in-documentation/https://techwriters.org/es/articles/diagrams-as-code-in-documentation/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Diagramas como código: cuándo ayudan y cuándo no, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Diagramas como código: cuándo ayudan y cuándo no» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/docs-as-code-without-fanaticism/https://techwriters.org/es/articles/docs-as-code-without-fanaticism/Thu, 13 Aug 2026 00:00:00 GMTDocs-as-Code no significa obligar a todos los redactores a trabajar en un IDE. El objetivo es combinar texto versionado, edición web, previews, comprobaciones automáticas útiles, revisión humana y publicación predecible.https://techwriters.org/es/articles/docs-tools-then-and-now/https://techwriters.org/es/articles/docs-tools-then-and-now/Thu, 13 Aug 2026 00:00:00 GMTLos formatos y pipelines cambiaron muchísimo, pero los problemas duraderos son familiares: control de fuente, reuse, navegación, review y sincronización entre producto y contenido publicado. Mucho antes de que “Docs-as-Code” fuera una etiqueta, los equipos lidiaban con múltiples fuentes, fragmentos reutilizados, versiones y la pregunta de cuál copia era actual.https://techwriters.org/es/articles/documentation-debt-triage/https://techwriters.org/es/articles/documentation-debt-triage/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Deuda de documentación: cómo encontrar lo que realmente perjudica al usuario, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Deuda de documentación: cómo encontrar lo que realmente perjudica al usuario» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/documentation-in-ci-cd/https://techwriters.org/es/articles/documentation-in-ci-cd/Thu, 13 Aug 2026 00:00:00 GMTTrata la documentación como un artefacto de build: valida estructura, enlaces, ejemplos y reglas antes de publicar. CI no decide si una explicación es útil, pero elimina defectos predecibles antes de gastar atención humana.https://techwriters.org/es/articles/documentation-lead-without-bureaucracy/https://techwriters.org/es/articles/documentation-lead-without-bureaucracy/Thu, 13 Aug 2026 00:00:00 GMTUn responsable de documentación debe reducir incertidumbre, no añadir otra capa de aprobación. Define propiedad, estándares y escalado, pero mantén la publicación rutinaria rápida y cerca de quienes conocen el producto. Cuando la documentación se reparte entre varios equipos, aparece la tentación de centralizar todo.https://techwriters.org/es/articles/documentation-metrics-that-matter/https://techwriters.org/es/articles/documentation-metrics-that-matter/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Métricas de documentación más útiles que las visitas de página, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Métricas de documentación más útiles que las visitas de página» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/documentation-ownership-map/https://techwriters.org/es/articles/documentation-ownership-map/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Un mapa de propiedad de la documentación sin burocracia, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Un mapa de propiedad de la documentación sin burocracia» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/documentation-review-workflow/https://techwriters.org/es/articles/documentation-review-workflow/Thu, 13 Aug 2026 00:00:00 GMTUn buen proceso hace visible la responsabilidad, reduce esperas y separa revisión factual, editorial y de producto. Define autor, revisor factual, editor y owner final.https://techwriters.org/es/articles/documenting-api-errors/https://techwriters.org/es/articles/documenting-api-errors/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Documentar errores de API para que el desarrollador pueda recuperarse, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Documentar errores de API para que el desarrollador pueda recuperarse» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/documenting-rest-api/https://techwriters.org/es/articles/documenting-rest-api/Thu, 13 Aug 2026 00:00:00 GMTUna buena documentación de API combina contratos legibles por máquina con explicaciones humanas, ejemplos ejecutables y errores explícitos. La documentación REST tiene dos audiencias: máquinas y personas.https://techwriters.org/es/articles/editing-drills-for-technical-writers/https://techwriters.org/es/articles/editing-drills-for-technical-writers/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Ejercicios de edición que mejoran la escritura técnica, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Ejercicios de edición que mejoran la escritura técnica» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/entering-technical-writing/https://techwriters.org/es/articles/entering-technical-writing/Thu, 13 Aug 2026 00:00:00 GMTHace tres años bastaba con escribir bien, aprender algunas herramientas y crear un portafolio. En 2026 la entrada es más difícil: la IA produce borradores, los equipos son más pequeños y se espera que el technical writer verifique hechos, entienda APIs, use Git y se responsabilice del sistema de documentación.https://techwriters.org/es/articles/first-90-days-in-documentation-team/https://techwriters.org/es/articles/first-90-days-in-documentation-team/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Los primeros 90 días en un equipo de documentación, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Los primeros 90 días en un equipo de documentación» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/forum-questions-that-aged-well/https://techwriters.org/es/articles/forum-questions-that-aged-well/Thu, 13 Aug 2026 00:00:00 GMTLos nombres de herramientas cambian más rápido que los problemas editoriales. Propiedad, terminología, screenshots, reuse y review siguen apareciendo porque reflejan decisiones de sistema más profundas. La respuesta técnica cambió de carpetas compartidas a repositorios y reglas de ownership.https://techwriters.org/es/articles/glossaries-and-terminology/https://techwriters.org/es/articles/glossaries-and-terminology/Thu, 13 Aug 2026 00:00:00 GMTUn glosario es útil cuando gobierna decisiones en producto, interfaz y documentación, no cuando solo acumula palabras. Registra término preferido, definición, variantes prohibidas o obsoletas, contexto y owner.https://techwriters.org/es/articles/hiring-technical-writers-without-trick-tests/https://techwriters.org/es/articles/hiring-technical-writers-without-trick-tests/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Contratar redactores técnicos sin pruebas trampa, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Contratar redactores técnicos sin pruebas trampa» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/hypertext-before-modern-docs-portals/https://techwriters.org/es/articles/hypertext-before-modern-docs-portals/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre El hipertexto antes de los portales modernos de documentación, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «El hipertexto antes de los portales modernos de documentación» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/information-architecture-for-growing-docs/https://techwriters.org/es/articles/information-architecture-for-growing-docs/Thu, 13 Aug 2026 00:00:00 GMTUna estructura que funciona con cincuenta páginas puede fracasar con quinientas. Diseña la navegación alrededor de las tareas del usuario, los tipos de contenido y los conceptos duraderos, no del organigrama. Una colección pequeña puede sobrevivir casi a cualquier navegación.https://techwriters.org/es/articles/learn-api-docs-by-building-a-small-api/https://techwriters.org/es/articles/learn-api-docs-by-building-a-small-api/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Aprende documentación de API construyendo una API pequeña, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Aprende documentación de API construyendo una API pequeña» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/llm-content-pipeline-guardrails/https://techwriters.org/es/articles/llm-content-pipeline-guardrails/Thu, 13 Aug 2026 00:00:00 GMTSi un modelo puede crear o actualizar contenido a escala, la validación debe escalar con él. Limita fuentes, conserva procedencia, valida estructura y separa la generación de la publicación privilegiada. Una arquitectura útil asume que el modelo se equivocará a veces.https://techwriters.org/es/articles/markdown-at-scale/https://techwriters.org/es/articles/markdown-at-scale/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Markdown a escala: convenciones que evitan el caos, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Markdown a escala: convenciones que evitan el caos» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/openapi-as-source-not-documentation/https://techwriters.org/es/articles/openapi-as-source-not-documentation/Thu, 13 Aug 2026 00:00:00 GMTUna descripción OpenAPI puede generar una referencia precisa, pero los developers siguen necesitando conceptos, flujos, autenticación, ejemplos y recuperación de errores que un schema no puede explicar por sí solo. OpenAPI describe muy bien operaciones, parámetros, estructuras de request y response, status codes y schemas reutilizables.https://techwriters.org/es/articles/portfolio-for-technical-writer/https://techwriters.org/es/articles/portfolio-for-technical-writer/Thu, 13 Aug 2026 00:00:00 GMTLos equipos de contratación necesitan ver cómo investigas, estructuras y verificas documentación. Un buen portfolio explica problema, restricciones, proceso y resultado en lugar de mostrar capturas aisladas. Un artículo pulido demuestra que puedes producir texto pulido.https://techwriters.org/es/articles/release-notes-users-can-act-on/https://techwriters.org/es/articles/release-notes-users-can-act-on/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Notas de versión sobre las que el usuario puede actuar, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Notas de versión sobre las que el usuario puede actuar» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/structured-writing-rules-that-scale/https://techwriters.org/es/articles/structured-writing-rules-that-scale/Thu, 13 Aug 2026 00:00:00 GMTLa consistencia a escala nace de modelos de contenido, terminología y patrones reutilizables, no de pedir que todos memoricen una guía enorme. Codifica las reglas importantes en schemas y componentes. Un equipo pequeño puede apoyarse en hábitos compartidos y edición directa.https://techwriters.org/es/articles/style-guide-people-use/https://techwriters.org/es/articles/style-guide-people-use/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Una guía de estilo que la gente realmente usa, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Una guía de estilo que la gente realmente usa» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/synthetic-examples-and-hallucinations/https://techwriters.org/es/articles/synthetic-examples-and-hallucinations/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Ejemplos sintéticos: borrador útil, evidencia peligrosa, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Ejemplos sintéticos: borrador útil, evidencia peligrosa» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/technical-writer-2006/https://techwriters.org/es/articles/technical-writer-2006/Thu, 13 Aug 2026 00:00:00 GMTLas herramientas cambiaron radicalmente, pero el núcleo del oficio sigue reconocible: audiencia, evidencia, estructura, terminología y responsabilidad. En 2006 eran comunes herramientas de edición de escritorio, formatos ofimáticos y sistemas de ayuda mantenidos manualmente.https://techwriters.org/es/articles/technical-writer-skills-matrix/https://techwriters.org/es/articles/technical-writer-skills-matrix/Thu, 13 Aug 2026 00:00:00 GMTUna buena matriz ayuda a crecer y contratar. Una mala convierte rasgos vagos en falsa precisión. Evalúa capacidades observables y la complejidad de los problemas de documentación que una persona puede asumir. Los equipos suelen crear matrices cuando la contratación es inconsistente o las promociones se vuelven subjetivas.https://techwriters.org/es/articles/vale-style-linting/https://techwriters.org/es/articles/vale-style-linting/Thu, 13 Aug 2026 00:00:00 GMTEl linting de estilo aporta valor cuando detecta deriva terminológica, formulaciones de riesgo y defectos repetibles. Mantén pocas reglas, explicables y lo bastante silenciosas como para que un fallo tenga credibilidad. Un linter puede revisar miles de frases en segundos, así que es tentador codificar cada preferencia editorial.https://techwriters.org/es/articles/wcag-22-for-documentation/https://techwriters.org/es/articles/wcag-22-for-documentation/Thu, 13 Aug 2026 00:00:00 GMTLa accesibilidad no es solo una tarea de frontend. Los autores controlan headings, propósito de enlaces, alt text, tablas, instrucciones y la estructura de la que dependen las tecnologías de asistencia. Un tema puede aportar buen contraste y navegación por teclado, pero los autores deciden si el contenido es comprensible.https://techwriters.org/es/articles/when-manuals-shipped-on-cd/https://techwriters.org/es/articles/when-manuals-shipped-on-cd/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Cuando los manuales se distribuían en CD, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Cuando los manuales se distribuían en CD» con criterios prácticos, verificables y mantenibles para documentación técnica.https://techwriters.org/es/articles/working-with-subject-matter-experts/https://techwriters.org/es/articles/working-with-subject-matter-experts/Thu, 13 Aug 2026 00:00:00 GMTUna guía práctica y verificable sobre Cómo trabajar con expertos sin convertir cada revisión en una reunión, pensada para equipos que necesitan mantener la documentación clara y sostenible. Cómo abordar «Cómo trabajar con expertos sin convertir cada revisión en una reunión» con criterios prácticos, verificables y mantenibles para documentación técnica.