UTNianos

Versión completa: Libros: DO y DON'T DO.
Actualmente estas viendo una versión simplificada de nuestro contenido. Ver la versión completa con el formato correcto.
Buscando info sobre estructuras dinamicas, encontre esto:

dis.unal.edu.co/profesores/lucas/estructuras/pdf/EInf99.pdf

Sere marica.
Sere hincha pelota.

Pero.... por dos, son 130, si, 130 carillas de puro horror visual!!!! De puro culo que el que hizo el PDF utilizo una fuente con serif, seguramente porque es la fuente por defecto en los procesadores de texto... pero.... mierda, cada vez que intento sacar informacion de este libro, me doy cuenta que leo una carilla, y me dan ganas de ver "inteligencia artificial" con un emo en una habitacion llena de gilletes...

... no es que no posea didactica. No es que explique las cosas mal. En realidad, no lo puedo comprobar... pero puedo conjeturar, de que es un ejemplo de como NO debe hacerse un libro. Ademas de que al final del mismo, el codigo peca de falta de comentarios....

... ¿para que abro este topic?


Para que, cada uno y a su criterio, ponga los DO y DON'T DO de un libro medianamente extenso (45 pag para arriba). Los libros que, pese a todo, les resulto comodo como iba mostrandose los contenidos.


Talvez solo yo me de cuenta, por el diseñador grafico frustrado que todavia tengo adentro... pero bueno, escucho opiniones al respecto, de lo que les gusta y lo que les dificulta al leer un libro....
DO:
  • Código: En currier new o en su defecto otra letra de ancho fijo
  • Código: Separado del texto principal, preferentemente dentro de un rectangulo con un color de fondo levemente diferente (como las guias de Beej)
  • Código: Las lineas numeradas, del 1 al N
  • Diagramas: En el centro de la hoja
  • Diagramas: Separados del texto principal por un mínimo de 2 lineas.
  • Diagramas: Numerados.
  • Formulas: Al estilo paper matemático, con numero de referencia y centradas

DON'T DO:
  • Código: Usar nombres de variables largos. No es un programa completo, con usar letras y nombres cortos alcanza para demostrar un concepto.
  • Diagramas: Del mismo tamaño que una linea de texto.
  • Diagramas: Tachar componentes (desprolijamente) de un sistema para expresar la eliminación de los mismos
  • Formulas: Que nos tomen de parsers (cosas como por ejemplo (a+b^2)/c, aprendan LaTeX o a usar las formulas de Word.)

Por ahora se me ocurren esos. Algunos de ojear ese apunte, y otros que tenía desde antes :P

Saludos
URLs de referencia