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

Update spec status and/or publish? #43

Open
gkellogg opened this issue Aug 29, 2022 · 6 comments
Open

Update spec status and/or publish? #43

gkellogg opened this issue Aug 29, 2022 · 6 comments
Assignees

Comments

@gkellogg
Copy link
Member

These document was never published, but the specStatus indicates its a WG-NOTE. This causes issues when people look at the ED and see a reference to a non-existing note.

IMO, the group clearly intended to publish this as a NOTE, and it has been referenced. It also gets confused with the former CG note, which it obsoletes. IIRC, the WG is still capable of publishing this as a NOTE, and even with open issues, it should be done.

Noted in discussion on Framing: w3c/json-ld-framing#133 (comment) (w3c/json-ld-framing#133)..

In the interim, the specStatus should be DNOTE (Draft Group Note).

@gkellogg
Copy link
Member Author

Note, I changed status to DNOTE, and even tried ED and unofficial (sorry, intended to do this in a PR); it still references the /TR version as last published. Not sure why it does that. @iherman?

@iherman
Copy link
Member

iherman commented Aug 29, 2022

To be honest, @gkellogg, I don't really know. What happens if you set the status to base and you do not set the short name?

@gkellogg
Copy link
Member Author

ReSpec must be getting status from somewhere else. Commenting out the shortName doesn't change anything. Setting specStatus to "base" (locally) generates some errors:

W3C Working Group documents can't use "base" for the specStatus configuration option.
How to fix: Pleas see specStatus for appropriate status for W3C Working Group documents.
(plugin: "w3c/defaults")
Documents with a status of "base" can't be published on the W3C's /TR/ (Technical Report) space.
How to fix: Ask a W3C Team Member for a W3C URL where the report can be published and change latestVersion to something else.
(plugin: "w3c/headers")

Note that respecConfig does not contain a latestVersion, either. Using "unofficial" just reports the issue about latestVersion. I believe that the correct status for this should be DNOTE, as it is, in fact, a Draft Group Note, but not sure what to do about the Latest published version, though.

Although I believe it's still find to use a shortName, it's pretty odd that removing it doesn't cause it to go away.

@iherman
Copy link
Member

iherman commented Aug 30, 2022

Although I believe it's still find to use a shortName, it's pretty odd that removing it doesn't cause it to go away.

I agree. I would go as far as saying that, for documents marked as "undefined" or "base", this is a respec bug.

(I did play around with my local copy and it did not make me any wiser. The only hack I could see is to run a post generation script that removes that header.)

I believe that the correct status for this should be DNOTE, as it is, in fact, a Draft Group Note, but not sure what to do about the Latest published version, though.

The only proper way ahead is for the WG to officially publish this document as a Draft Note. The WG can do this, and that would remove all ambiguities.

Note, b.t.w., that the charter of the WG runs out... tomorrow! Something should be done about it...

Cc @plehegar

@gkellogg
Copy link
Member Author

Ouch! I thought the group was chartered to go quite a bit longer as a maintenance group. It will certainly have things to do to respond to RDF-star changes, and the YAML-LD activity (described in the charter) has really ramped up. Best if we can keep the group going then to establish a charter for a new group.

cc @BigBlueHat

@BigBlueHat
Copy link
Member

The JSON-LD WG was rechartered on January 19th, 2023 until January 31, 2025. Consequently, we're in a good position to formalize the note as a publication.

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

No branches or pull requests

3 participants