on those notes, i dont think those errors are categorized by caller action, those are internal state. NotFound should instead have an instruction "create this

on those notes, i dont think those errors are categorized by caller action, those are internal state. NotFound should instead have an instruction "create this object first using that SOP" or "stop the transaction from going through" Ratelimited has an instruction "try again in x ms" or "raise your rate limit following this SOP" PermissionDenied has an instruction "request permissions here" or "complete this oauth" as far as the flat error definition i think that rather than simple, its easy. its simpler to have each module define its own errors and have dedicated translation code to the libraries errors, rather than putting the translation and equivalencies between different modules errors within the library in the programmers head and code comments on the big error definition file.