Documentación ágil de
La promo termina en: 3d 16h 16m 30s 🔥
Obtendras:
Libro digitalVideo cursoActualizacionesGrupo privadoIncluye:
Código disponible:
Los tiempos cambian y con ello, la forma de hacer documentación también. En este libro aprenderás como las grandes empresas documentan la arquitectura aprovechando técnicas modernas como la documentación como código y aprovechando al máximo el tiempo para enfocarse en lo que realmente importa, que es que el software funcione.
Económico
Este libro contiene información que por otro medios costarían muchísimo dinero en cursos y capacitación, sin contar el tiempo invertido.
Ejemplos reales
Durante este libro analizaremos un caso de estudio completo, donde analizaremos los requerimientos y crearemos su documentación.
Documentación como código
La documentación como código es una técnica que consiste en la creación de documentos de arquitectura basado 100% en código.
Enfoque dirigido
En este libro exploraremos como se documenta la arquitectura en el mundo real y como las empresas ágiles han mejorado sus proceso para la generación de documentos de arquitectura.
Enfoque práctico
Aprende con una metodología práctica que explique las teoría, pero sobre todo, que exponga cosos reales que puedes aplicar en tu trabajo del día a día.
Ahorra tiempo
Internet está lleno de blog que no explican correctamente, con ejemplos incompletos y que no explican bien, lo que te llevara mucho más tiempo y dolor de cabeza.
Una breve reseña por parte del autor
Cuando comencé mi carrera en la industria del software (hace más de 18 años), siempre me llamó la atención la arquitectura de software, debido a que me gustaba entender como el software funcionaba, incluso, más allá de lo que cualquier usuario normal podía ver, me gustaba entender como funcionaban las cosas por dentro, por lo que literalmente, entraba a los repositorios de código y veía como estaba implementadas las cosas por dentro, prácticamente era como un minero, escarbando en el código para comprender el funcionamiento de las cosas y enserio que aprendí muchas cosas.
Durante mis expediciones por los repositorios, siempre me encontraba con que la documentación era pobre, un pequeño texto que explicaba de forma general el funcionamiento, algunos métodos comentados por aquí o algunas clases comentadas por allá, pero con suerte (y con mucha suerte) entre la documentación encontraba un diagrama de arquitectura, wow, ver un diagrama era revelador, ya que de un solo vistazo podía apreciar los elementos que componían el proyecto, como se comunicaban, las dependencias, protocolos de comunicación, tecnologías, etc. Ver un diagrama era entender en un minuto, lo que me podrías tomar horas o días con solo analizar el código y es justo allí, cuando nace mi pasión por la arquitectura de software y la importancia de documentarla el software de forma efectiva.
El objetivo de este libro es enseñarte a documentar arquitectura de software ágil, que se adapte a los tiempos modernos, donde los equipos de trabajo se han reducido de 10 o 20 personas, a células Scrum de 3 a máximo 8 personas, y donde los requerimientos pueden cambiar de manera frecuente y sin previo aviso.
En este libro vamos a cuestionar duramente la creencia de que entre más abundante sea la documentación, es mejor, que entre más refinado este un diagrama, aporta más valor, o incluso, que entre más elementos mostremos en un diagrama, da una mejor vista de la arquitectura, de esta misma forma, vamos a cuestionar la complejidad absurda que dan modelos como UML, SysML o ArchiMate, por lo que si tú eres de esas personas obstinadas que quiere hacer las cosas como dice el manual y no como es el mundo real, te invito ahora mismo a que dejes de leer este libro y busques uno de UML, SysML, ArchiMate o lo que sea, en este libro no vengo a enseñarte el manual, pues para eso seguro hay mejores y más completos libros que este, por el contrario, este libro pretende darte un vistazo fresco de cómo crear arquitectura de software con un enfoque ágil y del mundo real.
Finalmente, abordaremos unas de las tendencias más relevantes, que es la documentación como código, que consisten en la creación de la documentación de todo el software mediante herramientas de software, donde tanto el estilo del documento, como los diagramas mismos, son generados 100% mediante código, y no me mal intérpretes, no se trata de aprender otro lenguaje de programación, al contrario, son herramientas que con una sintaxis super simple, puedes crear diagramas de clases, secuencia, interacción, C4, etc.
¿Qué es la agilidad?
Herramientas
El modelo C4
Introducción a UML
Caso de estudio
Creando el documento de arquitectura
Documentación como código
Cada patrón de diseño está acompañado de un proyecto del mundo real
Finaliza en: 3d 16h 16m 30s 🔥
45.00 USD
25.00 USD
Deficiencia del proceso iterativo
En lugar de utilizar un enfoque de desarrollo de software tradicional y rígido, en el que se definen todos los requisitos y se planifica todo el proceso de desarrollo de antemano, las metodologías ágiles se enfocan en la entrega de pequeñas piezas de software de forma iterativa y continua, y se adaptan a los cambios a medida que surgen.
De esta misma forma, la documentación ágil se centra en los aspectos más relevantes de la arquitectura, permitiendo a los equipos de desarrollo entregar software de manera más rápida y sin perder la ventaja competitiva que les aporta la agilidad.
Crea documentación por niveles
Los niveles de arquitectura son una forma de estructurar la arquitectura del software en diferentes niveles de detalle para que sea más fácil de entender y comunicar. Hay cuatro niveles de arquitectura: negocio, aplicación, componentes y código.
Cada nivel de arquitectura ofrece una vista diferente del sistema de software, desde una perspectiva general en el nivel de negocio hasta una perspectiva técnica detallada en el nivel de código. Utilizar estos niveles de arquitectura permite a los arquitectos de software comunicar de manera efectiva la arquitectura del software a diferentes audiencias y en diferentes niveles de detalle.
Aprende a crear diferentes vistas de arquitectura
Las vistas de arquitectura son como una serie de fotografías que muestran diferentes aspectos de un sistema de software, desde diferentes perspectivas. Cada vista de arquitectura se enfoca en una parte específica del sistema, como su estructura, funcionalidad, seguridad o escalabilidad, y se representa en forma de diagramas o documentación.
Las vistas de arquitectura permiten a los arquitectos de software comunicar la estructura y el comportamiento del sistema a diferentes audiencias y detectar problemas de diseño temprano en el ciclo de desarrollo del software.
Crea diferentes diagramas para diferentes audiencias
Aprenderás a crear diferentes diagramas que cuenten diferentes historias para diferentes audiencias, de tal forma que iremos profundizando en el detalle de implementación técnico.
En este libro exploraremos diagramas de C4, como diagramas de contexto del sistema, diagramas de contenedores, diagramas de componentes y utilizaremos UML para crear los diagramas de alto nivel.
Odiamos documentar
Seamos claros, los programadores odiamos generar documentación, pero si a eso le sumas que los párrafos deben ser Arial de 18 puntos, los títulos 1 deben ser 32 puntos en negritas con fuente Montserrat en negritas y en color Azul oscuro, luego el titulo 2 debe ser a 24 puntos en negrita también en Azul más claro, el titulo 3 en 20 puntos con un azul más claro y en negritas, además, los fragmentos de código deben tener formato y estas coloreados debidamente, por otro lado, tenemos estilos específicos para texto en negritas, viñetas, sangrado, márgenes entre elementos, etc, etc, etc. Te aseguro si nos piden todas estas reglas de formato y no existe una persona que revise que se cumplan, los documentos van a salir “a como dios nos dé a entender”, es decir, con una serie inmensa de faltas de formato y estilo.
¿Y la documentación?
¿Has preguntado alguna vez por la documentación de la aplicación y nadie sabe donde está?, eso es muy común, por que la documentación no se versiona ni administra correctamente, por lo que los documentos van pasando de mano en mano (o mejor dicho, de correo en correo) entre el equipo de desarrollo y al final nadie es responsable de ella, por otro lado, nunca se encuentran los originales, con los que se creo el PDF o con el que se crearon los diagramas.
Crea documentos con código
La documentación como código es una técnica mediante la cual nos centramos solo en el contenido del documento, dejándole al software la tarea de darle estilos, generar los diagramas y publicar el resultado, de esta forma, un programador amará hacer documentación al mismo tiempo que la documentación se versiona junto con el código fuente de la aplicación.
Crear documentos como código permite mantener la documentación del software actualizada y consistente con el código, lo que mejora la calidad del software y reduce los errores causados por la documentación desactualizada. Además, reduce el tiempo y esfuerzo necesario para mantener la documentación del software.
El libro cuenta con más de 200 páginas, ni muy largo para aburrirte, ni muy corto para no aprender nada. Este libro esta pensado para que un desarrollador o arquitecto tengas las bases sólidas para documentar la arquitectura de un sistema, incluso, damos formato y herramientas para que las puedes implementar en tu día a día y no tengas que comenzar desde cero.
NO, el libro está en constante evolución, y todas las actualizaciones estarán disponibles de forma gratuita.
SI, tienes un plazo de 30 días para solicitar tu reembolso total en caso de que el libro no alcance tus expectativas.
Para comenzar, es el único libro en español que cubre temas tomo documentación como código, por otro lado, no solo explicamos la teoría, si no que exponemos un ejemplo real de un requerimiento y lo documentamos en su totalidad, finalmente, te damos herramientas que puedes reutilizar en tu día a día, como templetes, e imágenes Docker para construir tus documentos sin programar.
Si, al inicio de la página encontrarás el botón de descarga.
Todas las preguntas y sugerencias son bien recibidas, para eso contemos con un canal privado de Discord donde toda la comunidad de comunica y el auto mismo responde las dudas.
Solo es necesarios conocimientos básicos del proceso de construcción de software y conocimientos super básicos de programación, el resto lo explicamos en el libro.
Oscar Blancarte es un arquitecto de software con más de 18 años de experiencia en el mundo del desarrollo de software. Actualmente es arquitecto de software en Red Hat desde donde aporta su conocimiento y experiencia para clientes a nivel mundial.
Oscar Blancarte cuanta actualmente con varias certificaciones, como Java Programmer, Análisis y Diseño Orientado a Objetos (IBM) y Oracle IT Architect (Oracle), Red Hat Certified Specialist in Containers y Red Hat Certified Cloud-native Developer. A lo largo de su carrera ha trabajado para diversas empresas del sector de TI, entre las que destacan su participación en diseños de arquitectura de software y consultoría para clientes de los sectores de Retail, Telco y Health Care.
Oscar Blancarte es, además, autor de su propio blog https://www.oscarblancarteblog.com desde el cual está activamente publicando temas interesantes sobre Arquitectura de software y temas relacionados con la Ingeniería de Software en general. Desde su blog ayuda a la comunidad a resolver dudas y es por este medio que se puede tener una interacción más directa con el autor.
Además, es un apasionado por el emprendimiento, lo que lo ha llevado a emprender en diversas ocasiones, como es el caso de Codmind, una plataforma de educación online, Snipping Code, una plataforma de productividad para desarrolladores donde pueden guardar pequeños fragmentos de código repetitivos y Reactive Programming, la plataforma en la cual publica sus libros e invita a otros a desarrollar sus propias obras.
Patrones de diseño
La oferta finaliza en: 3d 16h 16m 30s 🔥
Descuento por tiempo limitado
Libro electrónico (PDF)Curso grabado (acceso 24x7) El curso está incluido, pero estará disponible a mediados de AbrilTempletes de arquitectura, casos de uso e historias de usuarioActualizaciones gratuitas de por vidaAcceso al grupo privado para resolución de dudas
No tienes nada que perder...
Si en 30 días el libro no alcanza tus expectativas te regresamos el 100% de tu dinero, sin preguntas, sin excusas.
Ver condiciones
Recomiendo este libro en su totalidad. El libro explica detalladamente cada patrón de diseño con ejemplos muy prácticos y de mucha utilidad algo que no se encuentra en otros libros.
Ivan Auditore
Software Enginner
Lo recomiendo plenamente para todas las personas relacionadas con el desarrollo de software, desde estudiantes, hasta arqutiectos que creen que no pueden aprender algo mas, no se arrepentiran.
Rafael Lopez
Software Enginner
Puedo decir de antemano que has realizado un gran trabajo, y es necesario mencionar que sobre este tema se ha escrito bastante, pero tu libro fue creado de manera especial, muy bueno.
Lenier Fontaine
Software Developer
© 2021, Copyright - Oscar Blancarte. All rights reserved.
