Documentación ágil de

|

La promo termina en: 3d 12h 55m 24s 🔥

$45.00 USD

$25.00 USD

Obtendras:

  • Libro digital
  • Video curso
  • Actualizaciones
  • Grupo privado

Incluye:

  • 200+ páginas
  • Próximamente
  • Sin costo
  • Para dudas

Código disponible:

  • Variado

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.

Documentación ágil de Arquitectura de software

Algunos de nuestros lectores trabajan en

Acceenture
waveswaveswaves

¿Qué encontrarás en este libro?

Estilos y patrones de diseño

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.

Estilos y patrones de diseño

Ejemplos reales

Durante este libro analizaremos un caso de estudio completo, donde analizaremos los requerimientos y crearemos su documentación.

Estilos y patrones de diseño

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.

Estilos y patrones de diseño

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.

Estilos y patrones de diseño

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.

Estilos y patrones de diseño

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.

waveswaves

Acerca del libro

Esta es una breve descripción del libro

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.

waveswaves

Índice del libro

El libro más completo del tema.

1

¿Qué es la agilidad?

  • El modelo en cascada
  • Proceso de software iterativo
  • ¿Qué es la documentación ágil?
2

Herramientas

  • Analizando las principales herramientas
  • Instalar y configurar las herramientas
  • Primeros pasos
3

El modelo C4

  • Notaciones del modelo C4
  • Diagrama de contexto del sistema
  • Diagrama de contenedores
  • Diagrama de componentes
  • Diagrama de código o UML
  • Diagramas dinámicos
  • Diagramas de despliegue
4

Introducción a UML

  • UML y el modelo C4
  • Diagrama de clases
  • Diagrama de secuencia
  • Diagrama de despliegue
  • Diagrama de interacción
5

Caso de estudio

  • El proyecto ACME Store
  • Requisitos del proyecto ACME Store
  • Análisis de los requisitos
  • Arquitectándo requerimientos
  • Diagrama de contexto del sistema (Nivel 1)
  • Diagrama de contenedores (Nivel 2)
  • Diagrama de componentes (Nivel 3)
  • Diagrama dinámico
  • Diagrama de despliegue
  • Diagramas de código (Nivel 4)
6

Creando el documento de arquitectura

  • Template base reutilizable
  • Análisis de las secciones del documento
  • Llenado del documento de arquitectura
7

Documentación como código

  • Documentación como código vs convencional
  • Ejemplos de documentación como código
  • Configuración del entorno de trabajo
  • Introducción a Markdown
  • Introducción a PlantUML
  • Instalando componentes de construcción
  • Publicación de la documentación

Cada patrón de diseño está acompañado de un proyecto del mundo real

Finaliza en: 3d 12h 55m 24s 🔥

45.00 USD

25.00 USD

¿Porqué la agilidad?

La agilidad ha llegado para quedarse y con ello, una nueva forma de crear arquitectura de software

waves

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.

modelo en cascada
waves

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.

vistas de la arquitectura por niveles
waves

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.

vistas de la arquitectura por niveles
waves

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.

vistas de la arquitectura por niveles

Documentación como código

Utiliza código para generar y mantener la documentación del software, permitiendo mantener la documentación actualizada y consistente con el código

waves

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.

los programadores odiamos documentar
waves

¿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.

Patrón Adapter
waves

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.

Documentación ágil de arquitectura de software

Crea los diagramas como código

Arrastra la barra del medio para ver como se crea un diagrama solo con código

diagrama de secuencia

Arrastra para ver la magia

Diagrama de clases

Arrastra para ver la magia

Diagrama de C4

Arrastra para ver la magia

lineline

Preguntas frecuentes

Si no resolvemos tus dudas, puedes escribirnos por medio del chat de la página

¿Qué tan extenso es el libro?
¿Tengo que pagar por las actualizaciones?
¿El libro cuenta con alguna garantía?
¿Qué diferencia tiene este libro con el resto?
¿Puedo descargar una muestra gratis?
¿Qué pasa si tengo una duda?
¿Qué conocimientos requiero?
waveswaves

Un poco sobre el autor

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.

waveswaves

Precio

Recuerda que todos nuestros productos cuenta con la garantía de 30 días.

Reactive programmingReactive programmingReactive programming
bg

Patrones de diseño

$45.00$25.00/USD

La oferta finaliza en: 3d 12h 55m 24s 🔥

Descuento por tiempo limitado

wave
  • wavesLibro electrónico (PDF)
  • wavesCurso grabado (acceso 24x7) El curso está incluido, pero estará disponible a mediados de Abril
  • wavesTempletes de arquitectura, casos de uso e historias de usuario
  • wavesActualizaciones gratuitas de por vida
  • wavesAcceso al grupo privado para resolución de dudas
precio
wave
Garantía

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

waves

Nuestros lectores dicen

Algunas de las personas que han tenido la oportunidad de leer mis libros.

Ivan Auditore

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

Rafael Lopez

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

Lenier Fontaine

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

wave

Otros de mis libros

Los siguientes libros también son de mi autoría.

Introducción a la arquitectura de software

Introducción a la arquitectura de software

La oferta finaliza en: 10d 12h 40m 🔥

$45$25 USD
Saber más
Introducción a los patrones de diseño

Introducción a los patrones de diseño

La oferta finaliza en: 10d 12h 40m 🔥

$45$25 USD
Saber más
Aplicaciones reactivas con React, NodeJS & MongoDB

Aplicaciones reactivas con React, NodeJS & MongoDB

La oferta finaliza en: 10d 12h 40m 🔥

$45$25 USD
Saber más
waveswaves

¿Tienes algo en mente?

Contáctame y haremos una llamada para ayudarte

Reactive programming
LinkedinYoutubeTwitterFacebook

© 2021, Copyright - Oscar Blancarte. All rights reserved.

Whatsapp