Re: Recomendaciones

From: Date: Mon, 23 Feb 2004 19:23:50 +0000
Subject: Re: Recomendaciones
References: 1 2 3  Groups: php.general.es 
Request: Send a blank email to general-es+get-45879@lists.php.net to get a copy of this message
El famoso framework en el que estoy trabajando espero que me ayude, entre otras cosas, en testeo y documentación :)
Si bueno, pero lo que pregunto es: vas a implementar alguna metodologia formal en particular ? Por que ? Para testeo, la idea en principio es UnitTesting. Para documentar, espero sacar no sólo el estilo del phpdoc, sino también cosas como flujos, etc.
Qué tipo de metodología formal se te ocurre que se podría automatizar? Quizá un ejemplo me aclare un poco a qué apuntas.
Respecto a la documentación, depende del cliente. Las opciones que uso
son:
PHPDoc o PHPDocumentor, para código. vnc2swf que es un VNC modificado, para mostrar el uso del sistema. Erwin o similar para el DER y después se puede agregar a medida lo que haga falta.
PHPDoc para un cliente ? No es muy tecnica esa documentacion ??
por eso te decía que depende del cliente, eso es generalmente cuando piden tercerizaciones de desarrollos. por otro lado, si le vendo el código fuente, el mismo debe incluir esa documentaciñon aunque él no la entienda (de hecho, probablemente tampoco entienda el código, no?) :D
A mi siempre me piden un manual con imagenes de cada pantallita y algo de descripcion funcional...el tipico manual de usuario.
te recomiendo para eso que pruebes el vnc2swf, al menos para los pedazos mas relevantes, ya que si una imagen vale mas que mil palabras, una imagen en movimiento vale mas que mil imagenes fijas :) -- Andrés Ferrando <anferr@mecon.gov.ar>

« previous php.general.es (#45879) next »