Según el propio Dennis Ritchie, el Manual de UNIX nació como un proyecto de documentación muy serio. Tanto empeño fue tomado en su elegancia que a menudo el código a documentar se corregía con tal de que "luciera bien" en las páginas del Manual.
Desde entonces, todo sistema UNIX (o clone) viene equipado con un sistema de ayuda electrónico llamado "Man Pages", cuya estructura respeta aquella del manual original de 1972. Y no solo la estructura sino además una buena parte de su contenido, como la del olvidado comando DC (Desktop Calculator).
El hecho de que un Manual sirva el doble propósito de documentar lo hecho y guiar lo que está por hacer, me ha parecido una idea digna se adoptar y es asi como he agregado al site oficial de Heritage/1 una serie de "libros" llamados respectivamente: "Operator's Manual", "Engineer's Manual" y "Programmer's Manual".
En estos días he dedicado gran tiempo a estructurar y generar contenido para el Engineer's Manual. No estoy seguro de que alguien lo leerá, pero como documentación seria del proyecto y como referencia para mi mismo, se presta muy bien, según estoy viendo.
Subscribe to:
Post Comments (Atom)
0 comments:
Post a Comment