-
Notifications
You must be signed in to change notification settings - Fork 8
remove normative language from Security Considerations #231
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
base: main
Are you sure you want to change the base?
Conversation
in response to action w3c/rdf-star-wg#175 |
Characters in different scripts may look similar (for instance, | ||
a Cyrillic "о" may appear similar to a Latin "o"). | ||
A character followed by combining characters may have the same visual representation | ||
<p>Multiple <a>IRIs</a> can have the same appearance. |
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.
These last four changes are not needed and, in my opnion, are less readable than the unchanged text.
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.
(this part of the PR isn't in the "preview" or "diff")
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.
@afs — I see these four lines (2035-2038) in both Preview and Diff. Perhaps try searching for Characters in different
? These lines are less obvious in the rendered pages than in the HTML source, because the HTML source has new lines that get folded into spaces in the rendered page.
@pfps — It's easier to know what "last four changes" you're talking about if you drag-select the plus-sign from the first line of concern down to the last line of concern. This also allows for easy suggestion of changes to the source, where I would currently have to start a new thread to insert such suggestion about all 4 of these lines.
<p>Multiple <a>IRIs</a> can have the same appearance. | ||
Characters in different scripts can look similar (for instance, | ||
a Cyrillic "о" can appear similar to a Latin "o"). | ||
A character followed by combining characters can have the same visual representation |
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.
I support the changes from may
to can
in these four lines (2035–2038).
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.
With @TallTed's suggestions.
Co-authored-by: Ted Thibodeau Jr <[email protected]>
addresses #183
I changed all capitalized BCP14 keywords, as well as some lowercase verbs that could also be mistaken for normative language.
I kept some (lowercase) "must"s and "may"s, when I considered that they were more idiomatic than the alternatives, and that the context made its clear that it was not normative text (e.g. "Care must be taken to...", "avoid IRIs that may look similar").
Preview | Diff