Erratas en la documentación de Domino 8.5
27 April, 2009 18:29:13 mangelcalvo 8.5 | Comentarios (2)
Escribir documentación es siempre una tarea muy minuciosa y de detalle. Confundir un pequeño valor puede llevar a toda la comunidad de usuarios del producto al caos más absoluto.
Han publicado una revisión de la la ayuda de Lotus Domino 8.5: Lotus Domino 8.5 Administrator Help updates.
En ella se detallan modificaciones de procedimientos, que ahora son exactamente al revés, o que si antes eran imposibles, ahora sí son posibles. Especialmente importante la revisión de ID Vault y DAOS, como por ejemplo el significado de DAOS_ENCRYPT_NLO=1
Si todavía no has leído la ayuda de Lotus Domino 8.5, entonces léela tranquilo, ya que las erratas ya han sido corregidas. :-)
Juan,
De acuerdo contigo en lo que indicas. La verdad es que no es fácil redactar un manual de manera correcta.... y además es muy aburrido :-) Pero es un documento fundamental en cualquier proyecto de desarrollo.
Un saludo
Nas, Miguel Ángel.
Muchas gracias por la información. ¡Qué razón tienes! Y además la gente profana al mundo informático debería saber que es una de las partes más odiada por los programadores de una aplicación y por una razón muy concreta : El hacer un manual, aparte de ser una tarea muy minuciosa y atenta al detalle, como dice Miguel Ángel, es además una tarea que NO DEBERÍA hacer el programador ( Excepto el manual técnico, que ése sí debe ser redactado por el analista y/o programador ).
El hacer un manual de uso para usuarios es una labor *especializada* que debería ser realizada por personas con la carrera adecuada ( Se me ocurre a botepronto Biblioteconomía, pero hay más por supuesto ).
El programador debe reunirse con el redactor de la documentación para aclararle dudas y para indicarle cómo funciona la aplicación. A partir de ahí es el redactor el que da su estilo al manual con la ortografía y gramática correcta y las capturas adecuadas, poniéndoselo lo más fácil al usuario de la aplicación.
Es una lástima que en el mundo real esto se cumpla muy pocas veces ... y todos sabemos la razón : escasez de tiempo y recursos por un mercado de las IT en España que está acostumbrado a lo rápido, cutre y *barato-cueste-lo-que-cueste* ...
En fin, con el tiempo y una caña .... algunos borrachos y al final todos muertos ... :-D
Saludos.