in swift, we seem to have a longstanding tradition of spelling out the vowels in the names we give to things. for example,
- ObjectIdentifier and not ObjID
- Substring and not Substr
- UnsafeMutableRawBufferPointer and not UnsafeMutRawBufPtr
- LazyPrefixWhileSequence and not LzyPfxWhileSeq
i’m not going to wade into the debate of which style is better, i am only pointing out that there is an established tradition in swift API naming. which is why i am surprised that esoteric truncations like Decl and Expr are becoming entrenched in the user-facing API of SwiftSyntax.
i’m well-aware that ‘Decl’ and friends have lived in the swift compiler for as long as it has been written in C++, but i always assumed that if it were ever to get surfaced in user-facing API (as SwiftSyntax will become once macros become widespread), that it would be known as Declaration.
Is Decl going to become a user-facing term, like