Skip to content
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

Bibliographic span specification conflates URIs (identifiers) and URLs (locators) #695

Open
ronaldtse opened this issue Oct 31, 2022 · 1 comment
Assignees
Labels
bug Something isn't working

Comments

@ronaldtse
Copy link
Contributor

ronaldtse commented Oct 31, 2022

  • URIs are identifiers and not necessarily resolvable (and we should not assume whether they are or not, it is the job of the editor).
  • URLs are location links and are resolvable.

The current implementation of bibliographic spans in fact conflates between identifiers and locators. ISO 690 differentiates them because it is necessary to in the rendering

  • DOIs are identifiers, rendered typically as doi: xxx/yyy. There are also ORCIDs and others.
  • For accessible URLs, they are rendered typically as Available at: https://xxx.

In order to encode location, we do:

* [[[mozilla,Mozilla Web XR]]],
span:organization[Mozilla],
span:title[Fundamentals of Web XR]
span:url[https://developer.mozilla.org/en-US/docs/Web/API/WebXR_Device_API/Fundamentals]

Not span:uri.

The following encoding:

* [[[edge_mesh,Edge Mesh]]],
...
doi: span:uri.doi[10.1109/ACCESS.2017.2739804].

Should list DOI as an identifier instead of a URI (something like this):

doi: span:identifier.doi[10.1109/ACCESS.2017.2739804].

In any case we're looking to differentiate the Identifier and the Locator. I believe there are many such instances that we may need to flesh out, and this ticket shouldn't be actioned until we can specify them.

Relevant document at: https://github.com/metanorma/SWF-Corpus_and_IEEEP2874-D2

@ronaldtse ronaldtse added the bug Something isn't working label Oct 31, 2022
@ronaldtse ronaldtse moved this to 🆕 New in Metanorma Oct 31, 2022
@ronaldtse ronaldtse moved this from 🆕 New to On hold in Metanorma Oct 31, 2022
@ronaldtse ronaldtse self-assigned this Oct 31, 2022
@opoudjis
Copy link
Contributor

opoudjis commented Sep 3, 2024

Hasn't been actioned for two years. The vaguery of

I believe there are many such instances that we may need to flesh out, and this ticket shouldn't be actioned until we can specify them.

means it will never be actioned. The distinction is W3C pedantry, and changing span:uri to span:url after two years, and breaking all existing markup that has used span:uri from hyperlinking, is something I won't allow.

There is no action on me (apart from breaking span:uri, which I am not prepared to do), so I am unassigning myself until there is.

@opoudjis opoudjis removed their assignment Sep 3, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working
Projects
Status: On hold
Development

No branches or pull requests

2 participants