Currently, the feature flag name for the additional options on code blocks is called --enable-experimental-code-block-annotations. Does anyone have a different suggestion?
When a feature stabilizes, the “experimental” part of the feature flag name is usually dropped. For example, the previous name for this flag, --enable-experimental-code-block would eventually become --enable-code-block, which does not well reflect what this flag does. @ronnqvist suggested adding another word, like “annotations” or “extensions”, to make the name clearer.
I’ve already updated the flag name in my PRs to --enable-experimental-code-block-annotations, but we wanted to bring it up for broader discussion here. Should we move forward with --enable-code-block-annotations as the eventual non-experimental flag?
The PR that introduces this flag is here: https://github.com/swiftlang/swift-docc/pull/1273