Papel blanco

La mezcla de tradicional y gil Documentacin del proyecto

Un proyecto Cartera Perspectiva

Fergal McGovern, fundador, VisibleThread

Destinatarios: Directores de TI, administradores de programas, jefes de proyecto, jefes de equipo de analistas de negocios

INTRODUCCIN

Como se reconocen los mritos de los enfoques giles e iterativos, para muchos directores de TI, gerentes de proyecto / programa y los cables de los analistas de

negocio, la pregunta es; cmo adaptar la documentacin del proceso actual para facilitar los enfoques tradicionales y giles a travs de una cartera de proyectos, a

menudo como parte de un esfuerzo ms amplio programa.

En este documento se muestra cmo es posible aplicar gil lado las prcticas de documentacin a lado con las prcticas de documentacin tradicionales. Se

presenta una gua prctica para la documentacin del proyecto, donde puede existir una mezcla de los proyectos tradicionales y giles.

Este documento es aplicable a la empresa ms grande con una variedad de estilos del proyecto y tendr especial relevancia para las empresas que buscan

adoptar enfoques ms giles para ciertos proyectos.

Tamao de los proyectos; Conejo, caballo o un elefante.

En primer lugar, es til tener en cuenta los tipos de proyectos que pueden existir en una cartera de proyecto tpico.

James y Suzanne Robertson, autores de 'Dominar el proceso de los requisitos'; categorizar los proyectos, ya sea como conejo, caballos o

elefantes. Esta es una delineacin til.

- Conejo Proyectos: muy giles, proyectos de corta duracin, pequeos equipos de co-localizados, no de misin crtica, a menos de $ 500k en el costo totalmente

cargado. Estos son no estratgica. Los ejemplos incluyen pequeos proyectos de migracin, creacin de sitios web esttica o actualizaciones simples a los

sistemas existentes.

- Caballo Proyectos: Estos son de mayor duracin, por lo general superior a 6 meses y tienden a tener equipos no colocated. El coste del proyecto oscilar entre

$ 500 mil a $ 10 millones como una regla de oro. En el extremo superior de la cantidad de dlares, el proyecto (s) puede tener un carcter estratgico. es

probable que participen terceras partes, tales como integradores externos y / o proveedores. Ejemplos de estos proyectos estn desplegando infraestructura

para apoyar un nuevo canal de comercializacin, un proyecto de inteligencia de negocio o una nueva capacidad de mandato de los conductores de regulacin.

- Elefante Proyectos: Estos son multianuales proyectos / programas relacionados que incluyen mltiples proyectos. Tienden a ser distribuido y tendrn

recursos de varios niveles de habilidad y antecedentes de negocios / tecnologa participantes. No se espera que muchos actores involucrados en el inicio

de participar durante la duracin del proyecto. El costo en dlares para stos estn por encima de $ 10 millones, que van a cientos de millones de

personas. proyectos de elefante son estratgicas para el negocio. integradores externos y / o terceros proveedores estarn involucrados en estos

proyectos como una regla. Ejemplos de este tipo de proyectos son el desarrollo y la implementacin de un nuevo sistema de facturacin, los proyectos de

almacenamiento de datos, o proyectos de integracin de sistemas, como resultado de una fusin o adquisicin.

Proyectos ms pequeos del estilo del conejo, que se define como menos de $ 500k en el coste total, tienden a ser co-ubicada y con frecuencia pueden trabajar sin necesidad de

una amplia documentacin. Nos centramos aqu en proyectos de caballos y elefantes.

2010 VisibleThread 1
 Papel blanco

Tradicional / CASCADA proyecto de documentacin

Vamos a revisar lo que sabemos acerca de los proyectos tradicionales / catarata.

Los proyectos tradicionales son impulsados por fases, cada fase produce un resultado. Los proyectos se describen como cascada, porque en una vista estricto, no se

iniciar una fase hasta que la fase anterior se ha completado y ha pasado por un proceso de puerta de fase o aprobacin. Cuando se identifican los problemas que

requiere un cambio, un control de cambio se emite ajustando de ese modo uno o todos; la lnea de tiempo, la dotacin de recursos y necesidades de las estimaciones

de costos.

En un nivel alto, un conjunto de fases tpicas y salidas de documentos asociados puede incluir:

Fase de iniciacin produciendo una Carta del proyecto y / o Visin documento

fase de anlisis produciendo una BRD ( Requisitos de negocio de documentos) de documentos, una Requerimientos funcionales

documento y una Requerimientos no funcionales documento

Fase de diseo produciendo una Arquitectura y Diseo y posiblemente una alambre documento en el caso de las iniciativas orientadas a la interfaz de usuario

Fase de implementacin produciendo una Ayuda y Usuario documentos

Prueba de fase / Validar produciendo una Plan de prueba documento

fase de despliegue produciendo una Plan de empleo documento

Visualmente, proyectos (cascada) tradicionales estn representados a continuacin.

La documentacin del proyecto AGILE

Los procesos giles enfatizan entrega iterativo. En lugar de asumir todos los requisitos detallados y las especificaciones estn definidos en la delantera,

proyectos giles adoptan un enfoque 'suficiente'. proyectos giles a anticipar el cambio y hornear que en el proceso.

Desde un punto de stand-documentacin, esto significa gil tiene algunas consideraciones y retos que son muy diferentes de la cascada:

1. En los proyectos giles, evoluciona de documentacin y las partes interesadas, intentar mantener la documentacin lo ms ligero posible, pero no ms

claro. Este ltimo punto requiere llamadas de juicio no triviales de proyecto con experiencia

2010 VisibleThread 2
 Papel blanco

partes interesadas, incluyendo los analistas de negocios y gestores de proyectos. Muy poca documentacin y que estn en problemas, demasiado y que

estn sobrecargados.

2. Uno de los principios bsicos del enfoque gil es: 'software que trabaja sobre una amplia documentacin'. Muchos defensores giles interpretan

errneamente que esto significa 'no hay documentacin' en absoluto. Este es un comportamiento muy peligroso, especialmente para los

proyectos de caballos y elefantes. El objetivo es llegar a 'basta' documentacin para el tipo de proyecto.

3. Las tcnicas de comunicacin transitorios estn fuertemente enfatizadas en proyectos giles; Los ejemplos incluyen las discusiones del equipo y artefactos fsicos,

tales como tarjetas de ndice en una pared. Estos funcionan bien para el proceso de 'aqu y ahora' de comunicacin donde la comunicacin verbal aumenta

contenido de la historia y donde los equipos son de ubicacin conjunta. la comunicacin transitoria, por su propia cuenta, sin embargo es insuficiente para los

proyectos de caballos y elefantes. Tambin es necesario la comunicacin persistente.

4. Los documentos que sirven como la mejor forma de comunicacin 'persistente'; es decir, la comunicacin de registro para proyectos giles. Se requiere

persistencia de la comunicacin para proyectos ms grandes en un contexto gil; para ayudar a comunicar a los participantes del proyecto no

co-localizados, para ayudar a coordinar los equipos, para archivar las decisiones de negocio clave y los cambios, para satisfacer los requisitos de auditora,

para ayudar a la comunicacin con los equipos de negocios y ejecutivos, para fomentar la 'memoria colectiva',

y finalmente; para ayudar a los equipos de mantenimiento despus de

despliegue.

Vamos a considerar un proyecto gil tpica desde un punto de vista de la documentacin.

El punto de partida; el inicio del proyecto, es similar a los proyectos tradicionales. Se trata de establecer una justificacin comercial y resulta en una carta y

/ o visin documento en un nivel alto.

proponentes giles se refieren a la etapa despus de inicio como iteracin-0 1. Esta es una iteracin especial donde el alcance y los requisitos de anlisis inicial se lleva

a cabo. Otras actividades de tipo 'preparacin' tambin se producen aqu; el montaje de la infraestructura tcnica, la creacin de instrumento de prueba para el

desarrollo basado en pruebas, el equipo de montaje, etc.

Despus de iteracin-0 viene una coleccin de iteraciones, cada iteracin la entrega de una rebanada de la funcionalidad de trabajo. Iteraciones son de duracin

determinada y tendern a ser entre 1 y 6 semanas. Un registro de las actividades priorizadas se utiliza para administrar una iteracin, con los mejores elementos

prioritarios entregados en cada iteracin. La cartera est nuevo grado de prioridad al final de cada iteracin. Cualquier documentacin creada est en paralelo revalidado y

ajustado en consecuencia.

Comn a todos los mtodos giles (SCRUM, Crystal, XP, etc.) es la nocin de que al final de cada iteracin, una implementacin debera ser posible. En la

prctica, las iniciativas de caballos y elefantes ms grandes, una coleccin de iteraciones comprender tpicamente un despliegue.

Por lo tanto, el inicio de la fase / iteraciones y salidas de documentos asociados pueden incluir:

Fase de iniciacin produciendo una carta del proyecto y documentar / o Visin

Iteracin-0 produciendo una BRD ligera doc y / o 'suficiente' Requerimientos funcionales y

Requerimientos no funcionales en formato documentado para comenzar la iteracin 1.

1 Existe cierto debate en la comunidad gil en cuanto a si una iteracin-0 es una fase distinta, sin embargo por adelantado la planificacin y los requisitos de las actividades de

anlisis a un nivel apropiado deben ser completados para proyectos giles para tener xito.

2010 VisibleThread 3
 Papel blanco

1..n iteracin cada iteracin produciendo una versin revisada de la Reserva, modificado Casos de uso o Historias, no Func Reqs., Pruebas, modelos de

diseo, posiblemente alambre documentos en el caso de las iniciativas orientadas a la interfaz de usuario y otros modelos documentados

auxiliares que permiten la iteracin de proceder.

Despliegue flexible Ayuda y Plan de mantenimiento

Visualmente, proyectos giles pueden representarse como:

AGILE Documentacin - RECOMENDACIONES.

Las siguientes son algunas recomendaciones especficas para la documentacin del proyecto gil para proyectos de caballos y elefantes ms grandes:

- Usar estructuras de documento 'con peso adecuado. proyectos giles requieren estructura y plantillas diferentes en comparacin con sus

contrapartes de proyectos tradicionales. En un escenario gil, que no es necesario incluir la misma cantidad de detalles por adelantado. pautas de

documentacin o plantillas deben tener una estructura que representa los aspectos clave que sean apropiados para el estilo de proyecto. Lanzar

una plantilla tradicional completo en un proyecto gil tiene poco sentido a fin de tratar de recortar hacia abajo segn sea apropiado.

2010 VisibleThread 4
 Papel blanco

Figura 3: Una plantilla formal de casos de uso que muestran niveles detallados de Figura 4: Uso simple plantilla del caso de las iniciativas ms giles
contenido. (VisibleThread referencia estructura) (VisibleThread referencia estructura)

- Realizar un seguimiento de los patrones de actividad y evitar que los documentos obsoletos. Compruebe los niveles de actividad de edicin de conjuntos de

documentos. documentacin del proyecto gil probablemente tendr cambios que se producen en el corpus de documentos de proyecto sobre una base muy frecuente.

Cualquiera de los nuevos documentos se pueden crear o editar documentos existentes sobre una base lo suficientemente. Por ejemplo, un nuevo caso de uso detallado

puede ser necesaria para una iteracin especfica, esto puede ser aadido como un nuevo doc o editado dentro de un doc existente. Esperar cambios al menos tan

frecuentemente como cada iteracin.

proyectos giles muestran niveles de actividad aplanadas repartidas uniformemente a lo largo del ciclo de vida. Para los proyectos tradicionales que

espera ver cambios se concentran en las fases tempranas de anlisis. Si usted no est viendo las frecuentes actualizaciones de documentos en un

escenario gil es necesario entender por qu.

Figura 5: Los niveles de actividad para un BRD en un proyecto tradicional. Cada punto Figura 6: Los niveles de actividad de un documento en un proyecto gil. Las

de la trama denota una edicin. La concentracin principal de ediciones se produce en ediciones se distribuyen uniformemente a travs de el
la fase de partida. (VisibleThread que muestra los niveles de actividad de un documento ciclo de vida. (VisibleThread que muestra los niveles de actividad para un documento

tradicional) gil)

2010 VisibleThread 5
 Papel blanco

- Realizar un seguimiento de la calidad del documento. Independientemente de si se est utilizando cascada o enfoques giles, el contenido dentro de los

documentos debe adherirse a los principios de 'inteligente', es decir; que deberan ser: especficos, medibles, alcanzables, realistas y de duracin

determinada. Compruebe si el lenguaje dbil y no especfica en las especificaciones. Utilizar herramientas para escanear documentos en masa para el

lenguaje dbil y ambigua.

Figura 6: Un conjunto de documentos que muestran posibles problemas de idioma. (VisibleThread que muestra el anlisis de calidad)

- Busque Dependencias. proyectos giles ms grandes rara vez se desarrollan en forma aislada. Cuando se tiene proyectos tradicionales y giles que se

ejecutan al lado del otro, la identificacin de las dependencias con los componentes de los sistemas existentes dentro ya travs de proyectos son cruciales.

Debido a la naturaleza del enfoque de 'slo lo suficiente', donde los equipos son auto-organizacin, el riesgo es que no hay suficiente cobertura de los

conceptos clave se describe en la documentacin y por lo tanto los actores tradicionales de proyectos no son conscientes del impacto. Las reglas de negocio

y decisiones tcnicas que afectan a las entidades de dominio principales es necesario indicar explcitamente en la documentacin y seguimiento para facilitar

el anlisis de impacto por equipos adyacentes.

- Capturar y validar NFR explcitamente, no como historias. Para ambos proyectos tradicionales y giles, faltan los requisitos no funcionales adecuados,

escalado, etc. rendimiento es de alto riesgo. Es una actividad especializada y requiere tcnicas de anlisis y validacin diligentes. Esto es doblemente

importante en los proyectos giles. Los requisitos no funcionales no son entidades funcionales; sin embargo, a menudo son tratados como historias en

proyectos giles. Esto es riesgoso. Tratarlos como entidades distintas. Utilizar representaciones tabulares, si es posible en el documento o una hoja de

clculo. Teniendo NFR comprobables fomentan diseos ms completos y promueve un mejor desarrollo impulsado por la prueba como casos de prueba

(y datos de prueba) son ms fciles de identificar.

- Par realizar inspecciones. Los documentos deben ser revisados activamente y de manera informal como parte del ciclo de produccin y de creacin de

documentos. Llevar a cabo estas revisiones informales una vez por semana, con el uso de diferentes interesados en el proyecto sombreros, por ejemplo, el

emparejamiento BA con probadores etc. Debido a la filosofa gil 'lo justo', a juzgar qu es necesario tanto contenido se convierte en una habilidad importante.

inspecciones par ayudar a este proceso.

- Utilizar automatizacin. proyectos giles ms grandes dentro de una cartera requieren un mayor grado de los tiles y el control del contenido de los

proyectos tradicionales. el contenido del documento debe ser analizado en tiempo real para evitar el estancamiento, de lo contrario se corre el riesgo de no

suficiente documentacin actualizada. Soluciones como VisibleThread han sido diseados expresamente para automatizar las mtricas que necesita para

equipos giles distribuidos. Para proyectos de caballos y elefantes ms grandes, elegir una solucin que apoya directamente a MS Office (MS Word y

Excel) y se puede realizar un seguimiento de las mtricas de contenido de documentos, tanto para proyectos giles cascada y en toda la cartera.

CONCLUSIN

La aplicacin de prcticas de documentacin gil lado a lado con las prcticas tradicionales de documentacin es posible. Al considerar cmo manejar esto,

tome un punto de vista de la cartera. Entender que los proyectos giles colocan una diferente

2010 VisibleThread 6
 Papel blanco

nfasis en la documentacin, con un enfoque que favorece gil 'lo justo'. Asegrese de que la documentacin suficiente est presente, en particular para proyectos

de caballos y elefantes ms grandes.

Adoptar las recomendaciones descritas en este documento para salvaguardar el xito del proyecto y considerar un enfoque de automatizacin para asegurar la

integridad de la documentacin de su cartera.

ACERCA VISIBLETHREAD

VisibleThread ayuda a los departamentos de TI corporativos crean documentacin del programa / proyecto superior, dando lugar a la entrega de proyectos de xito

para los proyectos tradicionales y giles. Nuestra estructura de documentos y herramientas de anlisis de calidad, junto con la capacidad de crear documentos de

mejores prcticas a medida, proporcionan a los clientes el conocimiento y las mtricas que necesitan para tomar mejores decisiones durante todo el ciclo de vida de

proyectos de TI. VisibleThread asegura un enfoque uniforme para la documentacin de TI que resulta en la coherencia en toda la cartera de proyectos dando salidas de

mayor calidad y costo de implementacin reducido.

2010 VisibleThread 7