Documentación Técnica, para desarrollo de sitios

[mofo!]

Hola, bueno, espero darme a entender.

Recien empezare con el desarrollo de un sitio para una imprenta, desde la cual ofrecera sus servicios, con opcion de venta en linea de estos, solo que el cliente me ha solicitado Documentación Técnica antes de iniciar el desarrollo, no me niego a hacerla y nunca he pensado que es de sobra, solo que me gustaria tener INFORMACION DE APOYO para generar esta Documentación Técnica.

Anteriormente he hecho documentacion para otros sitios solo que esta vez me desearia fuera mas completa y basada en estándares de desarrollo.

Por ello les pregunto, conoces paginas, documentación, manuales que ayuden a la generación adecuada de Documentación Técnica, donde poder conocer mas acerca de esta, requisitos, mejoras, recomendaciones, etc, etc, etc...

Les agradecere mucho y al final a todos nos servira.
bye!

[zangano]

Oshe, yo no entiendo, la documentación para que es??, tiene que ver con las maquinas de la imprenta o productos, o como navegar por el website o que!!!!

Bueno, cuando termines tu sitio, ahi nos pones la liga no, nomas pa ver un sitio para una empresa de ese tipo.

salu2

[mofo!]

no no no Zangano, ahi solo mencione lo que hare, las funciones de la imprenta no tienen relacion con la Documentacion.

De otra forma... lo que busco con los Puntos que debe llevar la Documentación Técnica para del desarrollo de Sistemas (en este caso un sitio en Internet).

Ese tipo de info por lo general uno se la salta y empieza a programar dando como resultado sitios con muchos problemas, la Documentación Técnica te ayuda a tener una idea clara de lo que desarrollaras.

Espero haberme explicado mejor.

[Aleph]

Te transcribo (ya que esta bien escrito ahi) de un libro de desarrollo, los fundamentos para una buena documentacion tecnica.

Un manual completo debería ser diseñado como un libro pequeño, con los siguientes temas:

· Introduccion
· Tabla de contenidos
· Guia del usuario
· Documentacion tecnica
· Guia del desarrollador
· Lista completa de las funciones

La guia del usuario debera describir detalladamente todas las caracteristicas de la interfaz de su aplicacion (si tiene alguna) para un usuario medio. No sea demasiado tecnico en esta seccion, ya que deberia ser una descripcion del tipo "como hacer". Asegurese de que se describe cada aspecto con detalle. La documentacion tecnica deberia escribirse para los usuarios y administradores interesados en los aspectos tecnicos y deberia contener los requisitos tecnicos de su aplicacion, normas utilizadas e introducidas, asi como informacion sobre el proceso interno de datos, si fuera de algun interes para el lector, y, por supuesto, su permiso de licencia. Si va a permitir a los clientes que vean y/o modifiquen el codigo fuente, incluya una guia del desarrollador para explicar la estructura del proyecto, el flujo de datos y las relaciones internas, asi como una lista de todas las funciones (incluidas las funciones internas) junto con una descripcion completa.

Espero que te sea util.

Saludos.

<div align="right">Guerrillero del ERF</div><div align="right" style="font-family:Verdana;font-size:10px">Sin utop&iacute;a la vida ser&iacute;a un ensayo para la muerte.</div>