Specification by Example - Historia de un equipo que no odia documentar

Specification by Example es un técnica que permite describir a través del uso de ejemplos el alcance de una funcionalidad.

El hecho de poner ejemplos en vez de redactar una definición abstracta ayuda a entender mejor el problema, descubrir antes puntos clave a tener en cuenta en el diseño y funciona muy bien para que todos los participantes en un proyecto estén “sincronizados” con el alcance.

Adicionalmente, utilizando herramientas como Concordion es posible automatizar la especificación, es decir, que los ejemplos descritos en la especificación cobren vida y se ejecuten con el resto de tests. De esta manera podemos tener una documentación que ayuda a comunicar y al mismo tiempo refleja el estado del sistema.

En nuestro grupo de desarrollo llevamos usando esta técnica durante más de un año obteniendo resultados muy buenos. En esta charla hablaremos sobre nuestra experiencia, como ha transformado a nuestro equipo y como ha conseguido que estemos mucho más conectados con las necesidades de nuestro cliente.

Transcript

1. Historia de un equipo que no odia documentar Rubén Martín Pozo @rmarpozo Specification by Example
2. Construir un framework para desarrolladores de portales La misión
3. ¿Cómo conseguimos no repetir los errores de otros proyectos? La pregunta
4. Por supuesto, lo construimos ágil
5. Entregas iterativas Integración Continúa Pruebas Automáticas Historias de usuario …
6. El equipo
7. Stakeholders
8. ¿Cómo nos entendemos con ellos?
9. PO, Historias, criterios de aceptación
10. ¿Será suficiente?
11. ¡¡¡ Vamos a escribir documentación !!!
13. ¡¡¡ Pero eso no es ágil !!!
14. “Working software over comprehensive documentation” Manifiesto Ágil
15. ¿Realmente necesitamos documentar?
16. “Working software over comprehensive documentation”
17. ¿Cómo sabemos que el producto está funcionando?
18. ¿Qué queremos conseguir con nuestras documentación?
19. Que nos ayude a que todas las personas que participan en un proyecto tengan la misma visión Objetivo 1:
20. Evitar tener que rehacer trabajo debido a ambigüedades y malas interpretaciones Objetivo 2:
21. Que nos proporcione una manera objetiva para saber cuándo hemos terminado el trabajo Objetivo 3:
22. Que permanezca en el tiempo, ayudando al equipo a adaptarse mejor a los cambios Objetivo 4:
23. Debe estar sincronizada con el producto en cada momento impidiendo que se quede obsoleta Objetivo 5:
24. ¿Existe algo que cumpla estos objetivos?
25. Nos pusimos a investigar… Google
26. Specification by example Gojko Adzic
27. Como cliente VIP quiero entregas gratuitas cuando compro varios libros Historia de usuario
28. Entrega gratuita: • La entrega será gratuita para clientes VIP cuando hayan comprado un número determinado de libros.
29. Entrega gratuita: • La entrega será gratuita para clientes VIP cuando hayan comprado un número determinado de libros. Tipo de cliente Contenido del carrito Entrega VIP 5 libros Gratis
30. Entrega gratuita: • La entrega será gratuita para clientes VIP cuando hayan comprado un número determinado de libros. Tipo de cliente Contenido del carrito Entrega VIP 5 libros Gratis VIP 4 libros Normal
31. Entrega gratuita: • La entrega será gratuita para clientes VIP cuando hayan comprado un número determinado de libros. Tipo de cliente Contenido del carrito Entrega VIP 5 libros Gratis VIP 4 libros Normal Regular 10 libros Normal
32. Entrega gratuita: • La entrega será gratuita para clientes VIP cuando hayan comprado un número determinado de libros. • El número de libros necesarios para conseguir la entrega gratuita será de cinco Tipo de cliente Contenido del carrito Entrega VIP 5 libros Gratis VIP 4 libros Normal Regular 10 libros Normal
33. Entrega gratuita: • La entrega será gratuita para clientes VIP cuando hayan comprado un número determinado de libros. • El número de libros necesarios para conseguir la entrega gratuita será de cinco Tipo de cliente Contenido del carrito Entrega VIP 5 libros Gratis VIP 4 libros Normal Regular 10 libros Normal Vip 5 lavadoras Normal
34. Entrega gratuita: • La entrega será gratuita para clientes VIP cuando hayan comprado un número determinado de libros. • El número de libros necesarios para conseguir la entrega gratuita será de cinco Tipo de cliente Contenido del carrito Entrega VIP 5 libros Gratis VIP 4 libros Normal Regular 10 libros Normal Vip 5 lavadoras Normal Vip 5 libros, 1 lavadora Normal
35. Entrega gratuita: • La entrega será gratuita para clientes VIP cuando hayan comprado un número determinado de libros. No se entregará de forma gratuita a clientes VIP o a clientes regulares si compran cualquier otra cosa que no sean libros. • El número de libros necesarios para conseguir la entrega gratuita será de cinco Tipo de cliente Contenido del carrito Entrega VIP 5 libros Gratis VIP 4 libros Normal Regular 10 libros Normal Vip 5 lavadoras Normal Vip 5 libros, 1 lavadora Normal
36. Tipo de cliente Contenido del carrito Entrega VIP 5 libros Gratis VIP 4 libros Normal Regular 10 libros Normal Vip 5 lavadoras Normal Vip 5 libros, 1 lavadora Normal Entrega gratuita: • La entrega será gratuita para clientes VIP cuando hayan comprado un número determinado de libros. No se entregará de forma gratuita a clientes VIP o a clientes regulares si compran cualquier otra cosa que no sean libros. • El número de libros necesarios para conseguir la entrega gratuita será de cinco
37. Living documentation
38. Ampliar los criterios de aceptación y convertirlos en especificaciones usando ejemplos
40. ¿Cómo escribimos la especificación?
41. Escribimos la especificación mientras refinamos las historias
42. Automatizamos la especificación mientras implementamos la historia
43. Vamos a automatizar usando Concordion
44. ¿Me lo enseñas?
45. ¿Qué errores hemos cometido?
46. Automatizar las especificaciones requiere tiempo no es barato
47. Especificaciones demasiado técnicas. Difíciles de entender demasiado técnico
48. Muchos problemas a la hora de automatizar desde el browser Webdriver
49. No siempre hemos conseguido implicar lo suficiente al negocio no estamos todos
50. ¿Qué hemos aprendido?
51. No escribas más ejemplos de los necesarios sé breve
52. Los ejemplos más interesantes suelen estar cerca de las fronteras del problema busca las fronteras
53. La especificación no es un script. Lo más importante es comunicar ojo con los scripts
54. Evita inventarte tus propios datos. Acude a las fuentes no inventes
55. ¿Por donde empiezo?
56. Infórmate, lee, participa en los foros… Fórmate tu propia opinión investiga
57. No hay verdades absolutas. Adapta la solución a tus necesidades cambia y adapta
58. Elige una funcionalidad sencilla de tu próximo sprint e intenta escribir una especificación usando ejemplos empieza con algo pequeño
59. Intenta que participen todas las personas involucradas en el proyecto cuanta más gente mejor
60. Comienza a automatizar cuando te sientas cómodo trabajando con ejemplos, no antes automatiza
61. El equipo
62. El equipo
63. Tienes que documentar …y lo sabes
64. Disfrutad especificando Rubén Martín Pozo @rmarpozo *Ningún creativo, fotógrafo o diseñador ha sufrido daños durante la elaboración de esta presentación. Todas las imágenes son de libre disposición (CC)