remove normative language from Security Considerations #231
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.
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.
(this part of the PR isn't in the "preview" or "diff")
There was a problem hiding this comment.
@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.
I support the changes from may to can in these four lines (2035–2038).
Co-authored-by: Ted Thibodeau Jr <[email protected]>
|
This was discussed during the #rdf-star meeting on 14 August 2025. View the transcriptw3c/rdf-concepts#231<gb> Pull Request 231 remove normative language from Security Considerations (by pchampin) [ms:CR] pchampin: PR 231 is ready. Related to actions we talked about earlier. ora: happy to have you merge it. <TallTed> I've got ~39 rdf-shapes notifications, plus all the sub-repos, needing review TallTed: need to ask for more time. ora: just ping pchampin when you're ready. TallTed: will put approve on whatever I've gone over. pchampin: I'd ask editors to merge this after TallTed's approvel as I'll be away until next Friday. gkellogg: I see TallTed's approval in the review. TallTed: I don't know which PRs are being discussed. If I approved, then merge it. If things have changed since the approval, please don't. ora: subtopic: w3c/rdf-n-quads#80 gkellogg: document we're focused on is n-triples, but echos through all turtle-like specs. I've been applying changes. |
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