Skip to content

Explicit requirements for rdf:langString and rdf:dirLangString - alternative #213

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

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

pchampin
Copy link
Contributor

@pchampin pchampin commented Jul 3, 2025

alternative to #212


Preview | Diff

@afs
Copy link
Contributor

afs commented Jul 3, 2025

"optional" ... "MUST be present if and only if" does not read very well. It's not an option.

Copy link
Member

@TallTed TallTed left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

tweaks for clarity

Comment on lines +937 to +938
<code>http://www.w3.org/1999/02/22-rdf-syntax-ns#dirLangString</code>,
It MUST be well-formed according to
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<code>http://www.w3.org/1999/02/22-rdf-syntax-ns#dirLangString</code>,
It MUST be well-formed according to
<code>http://www.w3.org/1999/02/22-rdf-syntax-ns#dirLangString</code>
and it MUST be well-formed according to

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<code>http://www.w3.org/1999/02/22-rdf-syntax-ns#dirLangString</code>,
It MUST be well-formed according to
<code>http://www.w3.org/1999/02/22-rdf-syntax-ns#dirLangString</code>.
It MUST be well-formed according to

I would rather cut the sentence, because the resulting sentence would be very long, and it alteady contains an "and" (line 941).

@TallTed
Copy link
Member

TallTed commented Jul 17, 2025

As @afs said, base direction is not really optional, because of the conditional requirement ("MUST be present if and only if"). Noodling on rephrasing --

      <li>A conditionally required <dfn>base direction</dfn>.
        It MUST be present
        IF AND ONLY IF the <a>datatype IRI</a> is
        <code>http://www.w3.org/1999/02/22-rdf-syntax-ns#dirLangString</code>,
        when it MUST be one of the following:<ul>
          <li>`ltr`, indicating that the initial text direction is set to left-to-right</li>
          <li>`rtl`, indicating that the initial text direction is set to right-to-left</li>
        </ul></li>

It might be worth another line saying something like, It MUST NOT be present if the <a>datatype IRI</a> is anything other than <code>http://www.w3.org/1999/02/22-rdf-syntax-ns#dirLangString</code>. This could be a NOTE or otherwise "quieter", as it's just reinforcing what has already been said by the (intentionally emphasized) IF AND ONLY IF.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants