I've always been a fan of self-documenting configuration, code, etc. The idea of maintaining a second document which somehow has to stay in sync with what is in the network is not realistic. Worse, it can lead you down the wrong path when the documentation says one thing and it's configured another way. You of course have to keep track of a certain amount of stuff, just because you can't search your entire network for a given answer. Like what ports customers are plugged into, or at least what switches.
Over the years, I've found that it's much better to come up with general architecture documents and also configuration standards instead of documenting every little thing. You need to document the things a skilled practitioner is going to need to come up to speed, not how every knob is turned. The standards are more so you don't have to deal with a hundred things configured a hundred different ways. On Thu, May 28, 2020 at 4:51 AM Adam Moffett <dmmoff...@gmail.com> wrote: > I realized last night that at some point no amount of documentation is > going to help the next guy. He'll either be able to understand what he's > seeing or he won't. If you drew me perfectly detailed pictures of a jet > turbine I still wouldn't understand all the nuance of it. Maybe it's > likewise with some of this network stuff. > > > On 5/28/2020 12:29 AM, Steve Jones wrote: > > It cant be done. I've tried. It's simply not doable. > > But really, what he asked > > On Wed, May 27, 2020, 2:08 PM Adam Moffett <dmmoff...@gmail.com> wrote: > >> All of the DCIM software I look at focuses on answering "What's plugged >> into what" and "what's in the rack". >> >> Those are important things to document, but how do you show or draw a >> VLAN bridged to a VPLS tunnel and other such shenanigans? >> >> >> >> -- >> AF mailing list >> AF@af.afmug.com >> http://af.afmug.com/mailman/listinfo/af_af.afmug.com >> > > -- > AF mailing list > AF@af.afmug.com > http://af.afmug.com/mailman/listinfo/af_af.afmug.com > -- - Forrest
-- AF mailing list AF@af.afmug.com http://af.afmug.com/mailman/listinfo/af_af.afmug.com
