-
Notifications
You must be signed in to change notification settings - Fork 146
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
chore: replace informative with non-normative for consistency #1015
Conversation
Done @frivoal :) |
Co-authored-by: Florian Rivoal <git@florian.rivoal.net>
Thank you @Bashamega. Help improving the quality and consistency of the text is always very much appreciated! |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
s/an non-normative/a non-normative/
:-)
Thanks for addressing this @Bashamega - please could you also address the terminology in the Document Conventions section, and the example within it? I also just noticed that the non-normative references, which are generated by tooling, are in a section called "Informative references" - I don't know if that can be changed, but in #914 when we discussed the preference for non-normative vs informative, that would have been a useful data point! The deliberate cases where "informative" were left are now looking quite confusing to me. Perhaps we should replace them with "informational" or something else that makes it clear that it is not a synonym for "non-normative"? |
@nigelmegitt The other parts are not coming from the source code, but from bikeshed (speced/bikeshed#3077). I'll follow up to get that addressed there, but this PR is a net improvement. As for the remaining instances of informative in the text, I think they're actually quite natural and better than alternative rephrasing (like "informational"). Unless you're specifically looking for them as we are here, I think it's unlikely anybody would notice anything unusual about them. |
fixes #914
Preview | Diff