He visto muchos diagramas de red que son un plato de espaguetis con iconos. Cuando algo falla de madrugada no ayudan. Lo que les enseño a mis alumnos:
- Un diagrama, una pregunta. Uno lógico ("qué subredes hay y quién habla con quién"), otro físico ("qué cable va a qué puerto"), otro de flujo si hace falta. Mezclarlos es lo que crea el plato de espaguetis.
- Leyenda y convenciones. Una línea continua es un enlace físico, una discontinua es una VPN, un color es una VLAN. Y se pone en el propio diagrama.
- Lo importante, grande. Direcciones, VLAN y velocidades de los enlaces troncales en la figura; el resto en una tabla al lado.
- Fecha, versión y autor. Un diagrama sin fecha es un rumor.
- Texto además de dibujo. Una tabla de direccionamiento (subred, máscara, puerta de enlace, quién la usa) se puede buscar con Ctrl+F y un dibujo no.
- En un sitio que se versione. Si el diagrama se genera a partir de un fichero de texto, se puede revisar en un cambio como el código.
Y una prueba: dale el diagrama a alguien que no lo ha visto y pídele que cuente el camino de un paquete de un ordenador a Internet. Si duda, el diagrama no está terminado.