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

[wg/data-shapes] Data Shapes WG Charter #476

Open
1 of 2 tasks
nicholascar opened this issue Aug 8, 2024 · 16 comments
Open
1 of 2 tasks

[wg/data-shapes] Data Shapes WG Charter #476

nicholascar opened this issue Aug 8, 2024 · 16 comments

Comments

@nicholascar
Copy link

nicholascar commented Aug 8, 2024

New charter proposal, reviewers please take note.

Charter Review

Proposed Data Shapes WG Charter
diff from charter template

What kind of charter is this? Check the relevant box / remove irrelevant branches.

  • New
  • New WG
  • New IG

SHACL was originally produced by the RDF Data Shapes Working Group.

If this is a new WG or IG charter request, link to Advance Notice, and any issue discussion.

Horizontal Reviews: apply the Github label "Horizontal review requested" to request reviews for accessibility (a11y), internationalization (i18n), privacy, security, and TAG. Also add a "card" for this issue to the Strategy Funnel.

Communities suggested for outreach: RDF-Star WG

Known or potential areas of concern: none

Where would charter proponents like to see issues raised?
in charter-drafts GH or This issue

Anything else we should think about as we review? not that we know of

Note: proposed chairs should be copied @... on this issue.

@nicholascar @PapoutsoglouE

@nicholascar nicholascar changed the title SHACL WG Charter [wg/shaclwg] SHACL WG Charter Aug 8, 2024
@pchampin pchampin removed their assignment Aug 14, 2024
@plehegar plehegar changed the title [wg/shaclwg] SHACL WG Charter [wg/shacl] SHACL WG Charter Sep 3, 2024
@plehegar plehegar removed the Agenda+ label Sep 3, 2024
@plehegar
Copy link
Member

plehegar commented Sep 3, 2024

Any reason why we can't reuse the original name of the Working Group? RDF Data Shapes Working Group

@caribouW3
Copy link
Member

The shortname was already 'data shapes', so it seems to make more sense.

@plehegar plehegar changed the title [wg/shacl] SHACL WG Charter [wg/data-shapes] SHACL WG Charter Sep 5, 2024
@caribouW3 caribouW3 changed the title [wg/data-shapes] SHACL WG Charter [wg/data-shapes] Data Shapes WG Charter Sep 6, 2024
@plehegar plehegar added the Advance Notice Sent Advance Notice of (re)chartering has been sent to the AC label Sep 12, 2024
@plehegar
Copy link
Member

Advance notice

@himorin
Copy link

himorin commented Sep 17, 2024

correct link for diff from template: https://services.w3.org/htmldiff?doc1=https://w3c.github.io/charter-drafts/charter-template.html&doc2=https://w3c.github.io/charter-drafts/2024/data-shapes.html

@himorin
Copy link

himorin commented Sep 17, 2024

(not within i18n review)

  • In 3.2 non-normative documents contains a text The group may produce other Community Group Reports, but there seems no mention about SHACL Community Group
  • links to SHACL 1.2 drafts are failing to have charter-drafts repository as its base (not sure why)

@plehegar
Copy link
Member

plehegar commented Sep 18, 2024

As a side, PING got a few suggestions (from @pes10k, not privacy related):

  • copy-editing improvements:
    • the only sentence in the 3 paragraph Motivation and Background section thats doing any work / needed is “The overarching goal of the SDWWG is to enable spatial data to be integrated within the wider Web of data; developing and maintaining standard patterns and specifications addressing these problems.” (not a normative concern, of course)
    • Again, there are abbreviations and references to other specs and technologies all over this charter that are not clear to the reader. I have no idea what a “SSN Ontology” or “SOSA vocabulary” vocabulary are when they’re described in the Scope section. Just some links and things would help!
  • describe relationship to the previous WG in the background

@caribouW3
Copy link
Member

  • describe relationship to the previous WG in the background

I added this text to refer to the previous group name: "This group will maintain specifications developed by the former RDF Data Shapes WG."

@himorin
Copy link

himorin commented Sep 27, 2024

no comment or request from i18n

@simoneonofri
Copy link

From a security perspective, it's useful to remember to include in Security Considerations, the possibility of attacks such as SPARQL Injection.

@caribouW3
Copy link
Member

From a security perspective, it's useful to remember to include in Security Considerations, the possibility of attacks such as SPARQL Injection.

Good point. It seems to me that it ought to filed as a spec issue (the security consideration in https://github.com/w3c/shacl/tree/main/shacl-sparql is short and very generic) rather than a charter issue. Do you want to file an issue there?

@nicholascar
Copy link
Author

From a security perspective, it's useful to remember to include in Security Considerations, the possibility of attacks such as SPARQL Injection.

Good point. It seems to me that it ought to filed as a spec issue (the security consideration in https://github.com/w3c/shacl/tree/main/shacl-sparql is short and very generic) rather than a charter issue. Do you want to file an issue there?

Yes, we see security as applicable per-Spec, but it;s hard to think of generic yet still useful things to say in the Charter.

@ruoxiran
Copy link

ruoxiran commented Oct 9, 2024

no comment from APA.

@plehegar
Copy link
Member

section 1: the background says "This group will maintain specifications developed by the former RDF Data Shapes WG.", which seems to be a statement about the scope of the Group more than the background. Maybe that sentence should move into the in-scope section?

section 2.1: out of scope section seems awkward: in scope makes it clear that the Group will develop specifications based on SHACL. Why the need to exclude something which is not include in the in-scope section?

section 3.1: for SHACL 1.2 Compact Syntax, it says "Status: Draft (from previous WG work)". The draft seems to be from the CG, not the previous WG.

section 5.1: this needs an update to describe the relation between RDF-Star and the Data Shapes Working Group. In other words, why is RDF-Start WG listed there?

section 5.2: s/None yet identified./None identified./

section 11.1: the table needs to be reduced to the "Initial Charter" entry, since this is not a rechartering.

caribouW3 added a commit to w3c/charter-drafts that referenced this issue Oct 17, 2024
@caribouW3
Copy link
Member

section 1: the background says "This group will maintain specifications developed by the former RDF Data Shapes WG.", which seems to be a statement about the scope of the Group more than the background. Maybe that sentence should move into the in-scope section?

This was added as a resolution of this comment, which was asking about background and previous group specifically.

section 2.1: out of scope section seems awkward: in scope makes it clear that the Group will develop specifications based on SHACL. Why the need to exclude something which is not include in the in-scope section?

IMHO the purpose of an out-of-scope section is to clarify that some other work that could also apply to the same use cases, scenarios, and/or solve similar or connected issues are excluded from the charter.
The charter template says it includes an out-of-scope section also for legal purposes (IPR commitments, most likely).

section 3.1: for SHACL 1.2 Compact Syntax, it says "Status: Draft (from previous WG work)". The draft seems to be from the CG, not the previous WG.

I removed "(from previous WG work)" since there's apparently no published draft from the RDF Data Shapes WG.

section 5.1: this needs an update to describe the relation between RDF-Star and the Data Shapes Working Group. In other words, why is RDF-Start WG listed there?

SHACL being completely RDF-based, I don't think it's needed to re-state that there's a technical dependency between those specs. Do you mean something else?

section 5.2: s/None yet identified./None identified./

Done.

section 11.1: the table needs to be reduced to the "Initial Charter" entry, since this is not a rechartering.

Done.

@svgeesus
Copy link
Contributor

In Success Criteria, why has template wording on security, privacy and accessibility been removed?

Same question for TAG Web Platform Design Principles .

@caribouW3
Copy link
Member

In Success Criteria, why has template wording on security, privacy and accessibility been removed?

Same question for TAG Web Platform Design Principles .

The template says it is "For specifications of technologies that directly impact user experience, such as content technologies, as well as protocols and APIs which impact content", which is not the case here. Those specs are not about Web design either, so if you check the design principles, it's unlikely that anything applies.

That said, Horizontal review by Accessibility/Security/Privacy is of course cited in the Coordination section, which also has a sentence about the TAG review.

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

No branches or pull requests

8 participants