VIII Jornadas de Enseñanza Universitaria de la Informática Cáceres ...

participen el alumno afectado y algunosprofesores (al menos, lógicamente, el director delproyecto).Prácticas recomendadas:• En general, aplicar de manera decidida yrigurosa los fundamentos del desarrollo.• Realizar revisiones técnicas formales,cruzadas con otros alumnos o sólo conprofesores.Problemas mitigados: VI, VII, V8. DocumentaciónEn realidad, este punto es simplemente otra facetadel problema de la calidad. La necesidad de unabuena documentación es un caballo de batalla enlos entornos profesionales, y también en losacadémicos.Aquí merece la pena llamar la atención sobrela documentación relacionada con la gestión delproyecto en sí. Cuando se habla de“documentación”, con frecuencia se piensa endocumentación de análisis y diseño, que describeel programa, probablemente con el fin de facilitarsu mantenimiento. Pero siendo este un temaimportante, no es el único. Conviene reflexionarsobre la documentación del proyecto, que no serefiere de manera directa al programa sino a loque rodea a su desarrollo.Como ya se ha dicho, en muchos casos losproblemas de un proyecto no son técnicos, sino degestión. La falta de control del proyecto, laausencia de planes precisos y ordenados o la faltade información sobre decisiones adoptadaspreviamente puede ser tan nociva como una maladescripción del código fuente. Existe un problemaadicional con este tipo de documentos, quenuevamente va más allá del aspecto técnico: ladocumentación sobre el proyecto corre el riesgode convertirse en burocracia, que el alumnopercibe como inútil y que realiza cumpliendo unmero trámite.La documentación sería motivo para unestudio pormenorizado por sí misma, pero aquínos limitaremos a algunos apuntes relacionadoscon el tema que nos ocupa.Utilidad. Es fundamental que la documentaciónsea para el alumno una herramienta y que laperciba como tal. El director del proyecto puedeaprovechar algunas de las dificultades específicasque el PFC plantea al alumno (indefinición,incertidumbre, falta de control, dificultad...) paraque dicho alumno encuentre en sus propiosdocumentos el apoyo que necesita. Contra laindefinición, una buena lista de requisitos, quepueda consultar y actualizar con frecuencia;contra la incertidumbre, una buena planificación,y así sucesivamente.Creemos que puede ayudar a esto el que elalumno mantenga una buena organización yaccesibilidad de los documentos; imponemoscomo norma obligatoria el mantenimiento de unapágina web del proyecto, donde se encuentra todala documentación (Ilustración 3).Ilustración 3. Página web con ladocumentación de un PFCBurocracia. Hay que evitar a toda costa que elalumno perciba la documentación como unejercicio de burocracia gratuita. Además deconseguir que la documentación le resulte útil y