{"product_id":"docs-for-developers-an-engineers-field-guide-to-technical-writing-9781484272169","title":"Documentación para desarrolladores: Guía de campo de un ingeniero sobre redacción técnica","description":"\u003col\u003e\n\u003cli\u003e\u003cp\u003ePrimeros pasos\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003eInvestigación de la documentación\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003col\u003e\n\u003cli\u003e\u003cp\u003eComprensión de los usuarios\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eCultivar la empatía\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003eComprender los deseos del usuario, las necesidades del usuario y las necesidades de la empresa\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eReclutamiento de usuarios para la investigación\u003c\/p\u003e\u003c\/li\u003e\n\u003c\/ol\u003e\n\u003cli\u003e\u003cp\u003eMétodos de investigación \u003c\/p\u003e\u003c\/li\u003e\n\u003col\u003e\n\u003cli\u003eLectura de comentarios de código\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003ePonerlo a prueba\u003c\/p\u003e\u003c\/li\u003e\n\u003cp\u003eRegistros de fricción\u003c\/p\u003e\n\u003cli\u003e\u003cp\u003eRealización de grupos focales y entrevistas diversos e inclusivos\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eMapeo del recorrido del usuario\u003c\/p\u003e\u003c\/li\u003e\n\u003c\/ol\u003e\n\u003cli\u003eIdentificación y trabajo con los interesados\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003col\u003e\n\u003cli\u003e\u003cp\u003eEncontrar a sus expertos\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eDesarrollo colaborativo de la documentación\u003c\/p\u003e\u003c\/li\u003e\n\u003c\/ol\u003e\n\u003cli\u003eAprender del contenido existente\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003col\u003e\n\u003cli\u003e\u003cp\u003eEl valor de los documentos de diseño\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eEncontrar ejemplos en la industria\u003c\/p\u003e\u003c\/li\u003e\n\u003c\/ol\u003e\n\u003c\/ol\u003e\u003cli\u003eDiseño de la documentación \u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\u003col\u003e\n\u003cli\u003e\u003cp\u003eDefinición del conjunto inicial de contenido\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eDecidir la documentación mínima viable \u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003eElaboración de criterios de prueba y aceptación \u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003c\/ol\u003e\u003cli\u003e\u003cp\u003eComprensión de los tipos de contenido\u003c\/p\u003e\u003c\/li\u003e\u003cli\u003e\u003cp\u003eConceptos, tutoriales y documentación de referencia \u003c\/p\u003e\u003c\/li\u003e\u003cli\u003eComentarios del código\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\u003cli\u003e\u003cp\u003eEspecificaciones de la API\u003c\/p\u003e\u003c\/li\u003e\u003cp\u003eREADMEs\u003c\/p\u003e\u003cli\u003e\u003cp\u003eGuías\u003c\/p\u003e\u003c\/li\u003e\u003cli\u003e\u003cp\u003eNotas de la versión\u003c\/p\u003e\u003c\/li\u003e\u003cli\u003eRedacción de la documentación\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003col\u003e\n\u003cli\u003e\u003cp\u003ePrepararse para el éxito de la escritura\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003e¿Para quién es esto? Personas, requisitos, tipos de contenido\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003eDefinición de \"terminado\"\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eCómo iterar\u003c\/p\u003e\u003c\/li\u003e\n\u003c\/ol\u003e\u003cp\u003eHerramientas y consejos para escribir borradores\u003c\/p\u003e\n\u003col\u003e\n\u003cli\u003e\u003cp\u003eComprender sus necesidades\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eElegir sus herramientas de escritura (escritura a mano, solo texto, herramientas de escritura de productividad\/medición)\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003e\"Trucos\" para empezar a redactar contenido\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003c\/ol\u003e\u003cli\u003e\u003cp\u003eMecánica\u003c\/p\u003e\u003c\/li\u003e\u003cli\u003e\u003cp\u003eEncabezados\u003c\/p\u003e\u003c\/li\u003e\u003cli\u003ePárrafos\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\u003cli\u003e\u003cp\u003eListas\u003c\/p\u003e\u003c\/li\u003e\u003cp\u003eNotas y advertencias\u003c\/p\u003e\u003cli\u003e\u003cp\u003eConclusiones\/pruebas\u003c\/p\u003e\u003c\/li\u003e\u003cli\u003e\u003cp\u003eUso de plantillas para formar borradores\u003c\/p\u003e\u003c\/li\u003e\n\u003col\u003e\n\u003cli\u003ePropósito de una plantilla\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eCómo derivar una plantilla de documentos existentes\u003c\/p\u003e\u003c\/li\u003e\n\u003cp\u003eCómo llevar las plantillas al texto \u003c\/p\u003e\n\u003c\/ol\u003e\u003cli\u003e\u003cp\u003eRecopilación de comentarios iniciales\u003c\/p\u003e\u003c\/li\u003e\u003cli\u003e\u003cp\u003eMétodos de retroalimentación\u003c\/p\u003e\u003c\/li\u003e\u003cli\u003eIntegración de la retroalimentación\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\u003cli\u003e\u003cp\u003eObtención de comentarios de colaboradores difíciles\u003c\/p\u003e\u003c\/li\u003e\u003cp\u003eEdición de contenido para publicación\u003c\/p\u003e\n\u003col\u003e\n\u003cli\u003e\u003cp\u003eDeterminar el destino\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eHerramientas de edición (Grammarly, linters, etc.)\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003eDeclarar \"suficientemente bueno\"\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003c\/ol\u003e\u003cli\u003e\u003cp\u003eRecapitulación, estrategias y tranquilidad\u003c\/p\u003e\u003c\/li\u003e\u003cp\u003eEstructuración de conjuntos de documentación\u003c\/p\u003e\n\u003col\u003e\n\u003cli\u003e\u003cp\u003eDónde viven los tipos de contenido\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eConceptos, tutoriales y documentación de referencia \u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003eComentarios del código\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eEspecificaciones de la API\u003c\/p\u003e\u003c\/li\u003e\n\u003cp\u003eREADMEs\u003c\/p\u003e\n\u003cli\u003e\u003cp\u003eGuías\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eNotas de la versión\u003c\/p\u003e\u003c\/li\u003e\n\u003c\/ol\u003e\u003cli\u003eDiseño de su arquitectura de información\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003col\u003e\n\u003cli\u003e\u003cp\u003eEstilos de arquitectura de información de contenido\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eDiseño para la búsqueda\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003eCreación de rutas claras y bien iluminadas a través del contenido\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003c\/ol\u003e\u003cli\u003e\u003cp\u003ePruebas de usuario y mantenimiento\u003c\/p\u003e\u003c\/li\u003e\u003cli\u003e\u003cp\u003ePlanificación de la automatización de documentos\u003c\/p\u003e\u003c\/li\u003e\u003cli\u003eIntegración de ejemplos de código y contenido visual\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003col\u003e\n\u003cli\u003e\u003cp\u003eIntegración de ejemplos de código\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eCuándo y por qué usar ejemplos de código\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003eCreación de muestras concisas, utilizables y mantenibles\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eEstandarización de sus muestras\u003c\/p\u003e\u003c\/li\u003e\n\u003c\/ol\u003e\u003cli\u003e\u003cp\u003eUso de contenido visual: Capturas de pantalla, diagramas y videos\u003c\/p\u003e\u003c\/li\u003e\n\u003col\u003e\n\u003cli\u003eCuando su documentación pueda necesitar contenido visual\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eHacer que su contenido visual sea accesible \u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eIntegración de capturas de pantalla, diagramas\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003eVideos\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003c\/ol\u003e\u003cli\u003e\u003cp\u003eMedición del éxito de la documentación\u003c\/p\u003e\u003c\/li\u003e\u003cli\u003e\u003cp\u003eCómo tiene éxito la documentación\u003c\/p\u003e\u003c\/li\u003e\u003cli\u003eMedición de diferentes tipos de calidad de la documentación \u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003col\u003e\n\u003cli\u003e\u003cp\u003eCalidad estructural\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003e\u003cp\u003eCalidad funcional\u003c\/p\u003e\u003c\/li\u003e\n\u003cli\u003eCalidad del proceso\u003cp\u003e\u003c\/p\u003e\n\u003c\/li\u003e\n\u003c\/ol\u003e\u003cli\u003e\u003cp\u003eMedir lo que quieres cambiar\u003c\/p\u003e\u003c\/li\u003e\u003cp\u003eConclusiones\u003cbr\u003e\u003cbr\u003e\u003cb\u003eAutor:\u003c\/b\u003e \u003ca href=\"https:\/\/sureshotbooks-com.myshopify.com\/search?type=product%2Carticle%2Cpage\u0026amp;q=AUTH-14634997\"\u003eJared Bhatti\u003c\/a\u003e, \u003ca href=\"https:\/\/sureshotbooks-com.myshopify.com\/search?type=product%2Carticle%2Cpage\u0026amp;q=AUTH-14634999\"\u003eZachary Sarah Corleissen\u003c\/a\u003e, \u003ca href=\"https:\/\/sureshotbooks-com.myshopify.com\/search?type=product%2Carticle%2Cpage\u0026amp;q=AUTH-14635000\"\u003eJen Lambourne\u003c\/a\u003e\u003cbr\u003e\u003cb\u003eEditorial:\u003c\/b\u003e Apress\u003cbr\u003e\u003cb\u003ePublicado:\u003c\/b\u003e 10\/09\/2021\u003cbr\u003e\u003cb\u003ePáginas:\u003c\/b\u003e 240\u003cbr\u003e\u003cb\u003eTipo de encuadernación:\u003c\/b\u003e Tapa blanda\u003cbr\u003e\u003cb\u003ePeso:\u003c\/b\u003e 0.79 libras\u003cbr\u003e\u003cb\u003eTamaño:\u003c\/b\u003e 9.21 pulgadas (alto) x 6.14 pulgadas (ancho) x 0.53 pulgadas (profundidad)\u003cbr\u003e\u003cb\u003eISBN13:\u003c\/b\u003e 9781484272169\u003cbr\u003e\u003cb\u003eISBN10:\u003c\/b\u003e 1484272161\u003cbr\u003e\u003cb\u003eCategorías BISAC:\u003c\/b\u003e\u003cbr\u003e- \u003ca href=\"https:\/\/sureshotbooks-com.myshopify.com\/search?type=product%2Carticle%2Cpage\u0026amp;q=CAT-COM\"\u003eInformática\u003c\/a\u003e | \u003ca href=\"https:\/\/sureshotbooks-com.myshopify.com\/search?type=product%2Carticle%2Cpage\u0026amp;q=BISAC-COM060160\"\u003eInternet | Programación web\u003c\/a\u003e\u003cbr\u003e- \u003ca href=\"https:\/\/sureshotbooks-com.myshopify.com\/search?type=product%2Carticle%2Cpage\u0026amp;q=CAT-COM\"\u003eInformática\u003c\/a\u003e | \u003ca href=\"https:\/\/sureshotbooks-com.myshopify.com\/search?type=product%2Carticle%2Cpage\u0026amp;q=BISAC-COM051390\"\u003eProgramación | Código abierto\u003c\/a\u003e\u003cbr\u003e\u003cbr\u003e\u003c\/p\u003e\u003cp\u003e\u003cb\u003eAcerca del autor\u003c\/b\u003e\u003cbr\u003e\u003c\/p\u003e\u003cp\u003eJared Bhatti\u003cbr\u003e\u003c\/p\u003e\u003cbr\u003eJared es un escritor técnico sénior en Alphabet y cofundador del equipo de documentación de Google Cloud. Ha trabajado durante los últimos 14 años documentando una variedad de proyectos en Alphabet, incluidos Kubernetes, App Engine, Adsense, los centros de datos de Google y los esfuerzos de sostenibilidad ambiental de Google. Actualmente dirige la documentación técnica en Waymo y asesora a varios escritores junior en la industria. \u003cp\u003e\u003c\/p\u003eZachary Sarah Corleissen \u003cp\u003e\u003c\/p\u003eZach comenzó este libro como el escritor técnico principal de la Linux Foundation y lo terminó como el primer escritor técnico sénior de Stripe. Zach fue copresidente de la documentación de Kubernetes desde 2017 hasta 2021, y ha trabajado anteriormente en la documentación para desarrolladores en GitHub, Rackspace y varias startups. Disfrutan hablando en conferencias y les encanta asesorar a escritores y oradores de todas las habilidades y orígenes. \u003cp\u003e\u003c\/p\u003eHeidi Waterhouse \u003cp\u003e\u003c\/p\u003eHeidi pasó un par de décadas en Microsoft, Dell Software y muchas, muchas startups aprendiendo a comunicarse con y para desarrolladores. Actualmente trabaja como defensora principal de desarrolladores en LaunchDarkly, pero se sintió aliviada al descubrir que la comunicación técnica es universal en todos los roles. \u003cp\u003e\u003c\/p\u003eDavid Nunez \u003cp\u003e\u003c\/p\u003eDavid dirige la organización de escritura técnica en Stripe, donde fundó el equipo de documentación interna y escribió para la revista Increment. Antes de Stripe, fundó y dirigió la organización de escritura técnica en Uber y ocupó un puesto de liderazgo en documentación en Salesforce. Después de haber dirigido equipos que han escrito sobre la nube, infraestructura propia, camiones autónomos e infraestructura económica, ha estudiado las muchas formas en que la documentación técnica puede moldear la experiencia del usuario. David también actúa como asesor para varias startups en el espacio de las plataformas de conocimiento. \u003cp\u003e\u003c\/p\u003eJen Lambourne \u003cp\u003e\u003c\/p\u003eJen lidera la disciplina de escritura técnica y gestión del conocimiento en Monzo Bank. Antes de su incursión en las fintech, dirigió una comunidad de documentaristas en todo el gobierno del Reino Unido como Jefa de Redacción Técnica en el Government Digital Service (GDS). Habiendo pasado del gobierno a las finanzas, reconoce que se siente atraída por la creación de contenido inclusivo y centrado en el usuario en industrias tradicionalmente hostiles. Le gusta usar herramientas para desarrolladores para gestionar documentos, desmitificar el proceso de escritura para ingenieros, asesorar a escritores junior y presentar sus aventuras en documentación en conferencias.\u003cp\u003e\u003c\/p\u003e\u003cbr\u003e","brand":"Apress","offers":[{"title":"Default Title","offer_id":42704859463917,"sku":"9781484272169","price":54.99,"currency_code":"USD","in_stock":true}],"thumbnail_url":"\/\/cdn.shopify.com\/s\/files\/1\/0550\/8097\/6621\/products\/img_cbb11571-9b04-477f-ab80-d029c7266001.jpg?v=1650004925","url":"https:\/\/sureshotbooks.com\/es\/products\/docs-for-developers-an-engineers-field-guide-to-technical-writing-9781484272169","provider":"SureShot Books Publishing LLC","version":"1.0","type":"link"}