as i write code that implements documentation extensions, i can’t help but keep getting reminded just how terrible a name “documentation extension” is.
extension has a specific meaning in swift, and well, everything we do here in the documentation tooling world is “documentation“-related. and
DocumentationExtensionImplementationThing is quite a gnarly name for a type.
do we have a better term for this concept?
A documentation extension extends the documentation for a symbol—it's meant to mirror Swift language feature name because it operates similarly. Are there other words besides 'extension' that describe the behavior more clearly?
well, we now have:
which is becoming very confusing when transferring these concepts over into a codebase.
i don’t know, but this was the reason for this thread, to brainstorm alternative terminology we can use for this idea