Network documentation that survives contact with reality
Perfect documentation is always out of date. Aim for the parts that stay true.
Writing
Switching, addressing, packets and the faults that live between the cable and the application: how to find them, and how to design so they are rarer.
Perfect documentation is always out of date. Aim for the parts that stay true.
Two devices can both follow the standard and still not interoperate.
Translating line by line produces a configuration that works until it does not.
A small thing that causes real mistakes when you work across platforms.
Shipping defaults are chosen so the device works out of the box, not so it is safe.
A directory of config files is not a recovery plan. Here is the gap.
Configuration as a transaction changes how confidently you can work.
The concepts transfer. The assumptions do not, and a few of them will bite.
Once you see the shared model underneath, moving between vendors stops being retraining.
Every error counter has a specific meaning. Knowing which is which turns guessing into diagnosis.