w3c / activitystreams

Activity Streams 2.0
https://www.w3.org/TR/activitystreams-core/
Other
276 stars 61 forks source link

Properly maintain OWL or other ontological information in machine-readable format #516

Closed tpluscode closed 3 months ago

tpluscode commented 3 years ago

Please Indicate One:

Re #416 #504 #514 #515, I think this deserves a general issue to address the issue at hand.

I would like to point to https://github.com/w3c/activitystreams/issues/514#issuecomment-802829258 by @nightpool

Our OWL schema is non-normative and best-effort, and not maintained by the working group

I find this unfortunate and hard to understand. The JSON-LD only provides the minimum term mappings. Does it mean that the only normative reference for the property domains/ranges, class hierarchy, etc is the HTML respec document? If only it had RDFa annotations...

Right now, however, the normative reference is not really machine-readable, with the spec document being predominantly targeted at human readers.

I'd kindly ask the group to actually maintain the OWL, or similar form of accurate semantic representation of the Activity Streams vocabulary.

tpluscode commented 3 years ago

@jasnell created the initial OWL document. Was it written by hand or exported from some tool like Protege?

jasnell commented 3 years ago

By hand :)

nightpool commented 3 years ago

Does it mean that the only normative reference for the property domains/ranges, class hierarchy, etc is the HTML respec document?

Yes, there is not normative machine readable document. Even if we had a maintained OWL document, it would have to be non-normative—having multiple normative references for the same terms would invite a host of inconsistencies and contradictions.

nightpool commented 3 years ago

Also, correct me if I'm wrong, but I believe that since the spec has reached TR and the WG is no longer active, there is no longer scope for major normative changes like the one—the CG is only empowered to add narrow extensions to the current spec.

tpluscode commented 3 years ago

In such case it is good that the owl is not normative. We can apply can apply the necessary changes?

I do not propose anything major though. Only to have the normative text and the turtle actually matching.

It does not serve anyone to have any discrepancies between the two forms

jasnell commented 3 years ago

FWIW, The OWL was intentionally non-normative for precisely the reasons discussed here. It should be able to evolve without having to have some kind of official working group stamp every change. I would recommend that if there are changes necessary to keep it up to date, please do so.

cjslep commented 3 years ago

FYI go-fed has been maintaining its own documents for ActivityStreams and other ActivityPub related vocabulary, for the express purpose of machine readability. In our case, for code-generating the serialization and deserialization code required to flexibly parse the wide latitude of expected values into a statically typed language. Here is the example for ActivityStreams.

sebilasse commented 2 years ago

same as @cjslep … redaktor is also “maintaining its own documents for ActivityStreams and other ActivityPub related vocabulary, for the express purpose of machine readability.” Here is the example for all the terms we found in the fediverse (AS, AS extensions, AP and ideas) …

evanp commented 11 months ago

@gobengo has created an OWL ontology by scraping the HTML document. It's visible here:

https://github.com/gobengo/activitystreams2-spec-scraped/blob/master/data/activitystreams-vocabulary/1528589057.json

I think it's valuable to everyone to have non-normative descriptions of the specification in different languages.

Given that we have an OWL vocabulary that has been slouching around this repository for 8-9 years, it makes sense to update that clearly.

Changes to that document that don't track the REC would be a problem, but giving implementers an automated way to check their code and data structures seems beneficial.

I'm unlikely to spend time maintaining this, but I'd be happy to merge PRs that bring the OWL ontology closer in line with spec.

steve-bate commented 10 months ago

I've also created an updated ontology at

https://github.com/steve-bate/activitypub-ontology.

My version is in RDF/Turtle and can be loaded into tools like Protégé and used with libraries like OwlReady2 (after converting from turtle to RDF/XML). The ontology is based on the Activity Streams 2.0 JSON-LD context which includes ActivityPub extensions. It looked like the scraped ontology doesn't have the AP extensions (?). I also created an ontology for the Mastodon-specific extensions for applications that need to parse existing Fediverse messages that have Mastodon definitions in the JSON-LD context.

evanp commented 7 months ago

In issue triage, we decided that the proper way to maintain this document is to move it to its own repository in GitHub, and solicit more volunteer contributions. Consequently, we've set up https://github.com/swicg/activitystreams2-owl as a new repository for this effort. We'll try to merge the history of the file from the AS2 repo, and maintain it there. Ideally, we can have some automation to keep this up to date.

@steve-bate and @gobengo I've added you to the repo. Let's figure out how to best support OWL for AS2!

ThisIsMissEm commented 7 months ago

The OWL file has now been moved to this repository, and history of the previous changes has been preserved: https://github.com/swicg/activitystreams2-owl

csarven commented 7 months ago

Sorry that I wasn't part of the triage discussion. And I also understand that you wanted to reach a decision.

That aside, I fail to understand why maintaining the AS2 OWL in a separate repo would be better or suitable in any way, or in other words a way to actually resolve this issue "properly maintain OWL". The call is not about organisation/management/access but rather specific technical changes that needs to be integrated into the document to meet the community's needs.

There is a huge cost to moving something like this, if anything but breaking links, discovery, and keeping related material further away from each other.

I think this repo (w3c/activitystreams) is still the most sensible place to continue the work on AS2 OWL irrespective to who owns the resource. For instance, the JSON-LD context was updated by other Groups given adequate reference from a Rec and implementation experience. The work on it didn't need to move to another repository. And, that's entirely separate from errata too.

I hope this decision can be reconsidered, and hope that the activitystreams-owl stays put here.

nightpool commented 7 months ago

I think you are seriously overstating the costs of this move and drastically downplaying the benefits. The fact of the matter is that the ActivityStreams editors are not interested in maintaining the OWL file. It is not a normative part of the spec, and it has always been an unofficial file provided "as-is" for the benefit of the community. By moving it outside of the main spec repo, the file will be able to be maintained by the community of users that are interested in utilizing it.

On Thu, Dec 7, 2023 at 5:39 PM Sarven Capadisli @.***> wrote:

Sorry that I wasn't part of the triage discussion. And I also understand that you wanted to reach a decision.

That aside, I fail to understand why maintaining the AS2 OWL in a separate repo would be better or suitable in any way, or in other words a way to actually resolve this issue "properly maintain OWL". The call is not about organisation/management/access but rather specific technical changes that needs to be integrated into the document to meet the community's needs.

There is a huge cost to moving something like this, if anything but breaking links, discovery, and keeping related material further away from each other.

I think this repo (w3c/activitystreams) is still the most sensible place to continue the work on AS2 OWL irrespective to who owns the resource. For instance, the JSON-LD context was updated by other Groups given adequate reference from a Rec and implementation experience. The work on it didn't need to move to another repository. And, that's entirely separate from errata too.

I hope this decision can be reconsidered, and hope that the activitystreams-owl stays put here.

— Reply to this email directly, view it on GitHub https://github.com/w3c/activitystreams/issues/516#issuecomment-1846270024, or unsubscribe https://github.com/notifications/unsubscribe-auth/AABZCV6H6Y3VT26F2TODV6TYIJHUHAVCNFSM4ZWXXGHKU5DIOJSWCZC7NNSXTN2JONZXKZKDN5WW2ZLOOQ5TCOBUGYZDOMBQGI2A . You are receiving this because you were mentioned.Message ID: @.***>

csarven commented 7 months ago

I was in the SWWG, and am well-aware of the history.


Whether the AS spec editors are interested in maintaining the RDF/OWL or not is irrelevant. The role of an editor is to follow the decisions of the group that has intellectual responsibility of the documents in question. If those particular editors are not interested, it doesn't imply that other people are not or can't take it on, and certainly doesn't entail that moving the work to another repo is an appropriate response. If anything, and evidently, change requests have been made by people besides the editors of completely different documents.

RDF/OWL is clearly being acknowledged as some sort of a "work item" of the SWCG. Have you sought editors/maintainers for the RDF/OWL document? If not, how about the other chairs? (I use the term "work item" liberally here but if you have a specific process on what constitutes a group's "work item" that I may have missed, please refer me to and I'll go with that.) If all we need is someone to explicitly put their hand up to "edit" or "maintain", sure, :hand: . See below for "process" though.

We may have to agree to disagree on what is more costly. I don't believe that moving the RDF/OWL file to another repository has actually addressed the key concerns of the community. The impression of something is being done or resolved is given but in reality files are being move to another location - arguably making it harder for anyone new to discover and get involved.

The actual needs/concerns that are brought forward are still:

Again, I'm not seeing an actual response to those things.

I've made some effort in getting people to review the work, sought W3C Team's technical opinion on what to do as and getting this published on W3C server once that's in the clear. Last mentioned at https://github.com/w3c/activitystreams/issues/416#issuecomment-1847543536


Again, this repository includes documents that are neither normative or "official" in any way above and beyond the RDF/OWL file. So, perhaps re-visit the reasoning behind what belongs in this repository, and clarify the actual process (or opinions) that's being followed. I mean, link to the actual process / decision policy, so that everyone is on the same page.

ThisIsMissEm commented 7 months ago

@csarven in order to keep the document in this repository, you'd want some sort of CI step to validate that the OWL file is indeed representing the same information as what's in the JSON-LD / vocabulary documents; that to my knowledge isn't something that exists, and means that any updates to one document or the other can quickly become out of sync.

csarven commented 7 months ago

But that's not in the order or required. That's plumbing. Does the AS2 JSON-LD Context gets automagically updated when AS core/vocabulary or vise versa changes?

It is hard to discuss this further when what we really need to still resolve is documenting decision making on RDF/OWL issues/PRs and having W3C update the ns. See the links I've dropped around.

tpluscode commented 7 months ago

in order to keep the document in this repository, you'd want some sort of CI step to validate that the OWL file is indeed representing the same information as what's in the JSON-LD / vocabulary documents; that to my knowledge isn't something that exists, and means that any updates to one document or the other can quickly become out of sync.

The proposed solution to move the OWL to another repository would further separate these document, making them fall out of sync even more.

nightpool commented 7 months ago

"RDF/OWL is clearly being acknowledged as some sort of a "work item" of the SWCG"

I do not agree with this characterization. The OWL file was a historical artefact of the spec's development, it was never an intentional work item or intended as anything more than informative

On Fri, Dec 8, 2023, 1:38 PM Tomasz Pluskiewicz @.***> wrote:

in order to keep the document in this repository, you'd want some sort of CI step to validate that the OWL file is indeed representing the same information as what's in the JSON-LD / vocabulary documents; that to my knowledge isn't something that exists, and means that any updates to one document or the other can quickly become out of sync.

The proposed solution to move the OWL to another repository would further separate these document, making them fall out of sync even more.

— Reply to this email directly, view it on GitHub https://github.com/w3c/activitystreams/issues/516#issuecomment-1847725005, or unsubscribe https://github.com/notifications/unsubscribe-auth/AABZCV7KJU7SFZCUWAXE5RDYINUDDAVCNFSM4ZWXXGHKU5DIOJSWCZC7NNSXTN2JONZXKZKDN5WW2ZLOOQ5TCOBUG43TENJQGA2Q . You are receiving this because you were mentioned.Message ID: @.***>

csarven commented 7 months ago

It is already acknowledged by some - if anyone but those that jumped into the whole moving process - SWCG by the mere fact that there was already a move / attempt to put the RDF/OWL file in the https://github.com/swicg (which is SW(I)CG space). On one hand you're backing the idea to move it to SWCG space but at the same time you don't want to acknowledge it as a "work item"??? Pick another word, I don't care. If some in the SWCG had no opinion on it as far as work is concerned, you wouldn't be touching w3c/activitystream to begin with. Furthermore, you want the SWCG to claim/maintain some kind of ownership of w3c/activitystreams but at the same time dismissing something that is quite literally related and significant to the material, and evidently has people interested in continuing the work.

All that you are repeating about the WG and what RDF/OWL is or isn't, which I am well-aware of, is irrelevant.

Would this from https://www.w3.org/groups/cg/socialcg/ suffice:

It is also a place to incubate new proposals which build on or complement the Social Web WG recommendations.

No? Please go ahead and refer me to charter/process/agreement... a decision policy of any sort that justifies what belongs to the SWCG and not, and how you're going at having any sense of group consensus.


Let me put it this way: If some folks have no interest in working on x, y, z, that's okay. Others are enthusiastic and have already shared their findings, issues/PRs to push things ahead. Supporting them or allowing them to proceed without hindrance would be great. Transitioning to a new repository is unnecessary friction and without resolving the underlying issues. What we need is an actual process to advance work. See the links I've dropped around.

cristianolongoodhl commented 6 months ago

See also #561

evanp commented 3 months ago

Based on conversation in the SocialCG meeting, and the fact that this document is referred to in our normative text, we will continue maintaining it in this repository as a deliverable of the WG and the CG.

evanp commented 3 months ago

Noting here that as the current editor of the AS2 documents, I'm taking responsiblity for managing this OWL document, with the help of the SocialCG and the larger AS2 community.