Subject: [NANOG] Re: The Network CLI -- Love it ? Hate it? Needed? Date: Wed, Mar 19, 2025 at 07:16:35AM -0500 Quoting Josh Reynolds via NANOG (nanog@lists.nanog.org):
I'd argue that's not documentation at all, but a statement of intent.
Yes, that's my impression too. And it is a worthy tool, but let's not confuse it with reality.
A *proposed* state or maybe even a snapshot of a particular time is more likely.
Documentation that deviates from reality will get ignored, forgotten and rejected. Treating it as plans and intents will work much better. We probably do that without reflecting over it already. Officially acknowledging it will only improve the process. -- Måns Nilsson primary/secondary/besserwisser/machina MN-1334-RIPE SA0XLR +46 705 989668 Xerox your lunch and file it under "sex offenders"!