I think there are Nostr insiders who hash out what they want to do (with examples) on Nostr, or at conferences. The NIPs are then written to record a consensus (or maybe just one side of a debate). They’re not thinking that some outsider might come along and want to read the specifications to understand the protocol.