Git Product home page Git Product logo

rdf-star-wg's Introduction

RDF-star Working Group

This is the main repository of the RDF-star working group. See:

For general issues about RDF-star and the RDF/SPARQL 1.2 family of specifications, you can raise an issue on this repository, or send an email to the public mailing list.

For more targeted discussion on one of the deliverables, use the corresponding repository.

Working Group documents

In addition to the related repositories referenced as deliverables above. Contributors should reference the Editor's Guide for general practices in editing specifications, submitting Pull Requests, and generally working with ReSpec.

Note that per the W3C Patent Policy, the group is only able to accept non-trivial contributions from Working Group members. However, comments and minor update suggestions from others are welcome.

Additional notes that are pertinent to Working Group discussions may be found in the wiki as well as the following:

Approximate WG Process Flow

  1. Create Issue asking question, pointing to problem, etc., with title and initial post as neutral as possible regarding (direction of) resolution. Raise general concerns on RDF-star WG repo; raise doc-specific concerns on specific relevant repo(s).

  2. Discuss in Issue and/or on mailing list and/or in telecons

  3. Upon general consensus of (direction of) resolution, create Pull Request with specifics

  4. Seek reviews of PR

  5. Massage content of PR until generally acceptable

  6. Merge PR

  7. Repeat as needed

rdf-star-wg's People

Contributors

afs avatar antoine-zimmermann avatar franconi avatar gkellogg avatar hartig avatar kasei avatar ktk avatar pchampin avatar pfps avatar rat10 avatar rdfguy avatar tallted avatar vladimiralexiev avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

rdf-star-wg's Issues

Use Case: Concept of Graph/Dataset without quoted triples

As an specification editor,
I want to be able to refer to the concept of a graph or dataset not including quoted triples,
So that algorithms such as that defined in RDF Dataset Canonicalization can be written to so as to not depend on the concept of triples as a resource (quoted triples).

This concept has been described as an "RDF 1.1 Dataset", but that may not include other desired components of an RDF 1.2 Dataset, hypothetically including support for text direction or other concepts other than embedded/quoted triples.

Comment for rdf:PlainLiteral in the specs

As suggested by @pfps (w3c/rdf-schema#10):

My suggestion for resolving the issue would be to add something to the comment for the datatype to the effect that rdf:PlainLiteral is no longer used in RDF itself, but that it continues to be part of RIF and OWL 2. But that isn't much of a change from the wording that is already there.

And I agree with the opinion.

Tagging task-force-specific discussions in email threads

I propose that we add a prefix of the form [NameOfTaskForce] to the topic of a new email thread when it is specific to the task force called NameOfTaskForce. This issue is to get a unique proposal of what prefixes to use for each task force and enforce their use by the WG, so as to simplify filtering those discussions or finding them in the future. Here is a proposal:

  • Use case task force: [UC] (clear, short, hardly possible to misspell it)
  • Semantics task force: [Sem] (rather clear, short and hard to misspell)
  • Editors task force: [ED] (somewhat clear, short and hardly possible to misspell)

Alternative:

  • Use case TF: [UC]
  • Semantics TF: [Semantics] (very clear but long and easy to misspell)
  • Editors TF: [Editors] (very clear but possible to misspell)

Duplicate or similar terms in semantics and concepts

There are two notes in the RDF Concepts drafts on Entailment and Equivalence that they are similar to the terms entails and equivalent in semantics.

Which is the appropriate primary definition?

Should one simply be a reference to another (e.g., <dfn data-cite=".RDF12-CONCEPETS#dfn-entailment">entails</dfn>)?

If parallel definition is appropriate, they should probably cross-reference each other and note subtlties.

As it is now, both specs will export these terms making them show up in xref to allow automatic resolution. Existing identifiers can be preserved in documents without exporting them (e.g., <span id="..></span>, or <dfn class="no export"></dfn>.

Probably at some point we should automate finding parallel term definitions in different specs which should be unified.

RDF* in CBOR?

We are working a new specification for a binary format using IETF CBOR called "Gordian Envelopes". We are planning to submit this spec for Gordian Envelopes that leverages deterministic CBOR as an IETF Internet-Draft by end of the week:

ABSTRACT: The envelope protocol specifies a format for hierarchical binary data built on CBOR. Envelopes are designed with "smart documents" in mind, and have a number of unique features including easy representation of semantic structures like triples, built-in normalization, a built-in Merkle-like digest tree, and the ability for the holder of a document to selectively encrypt or elide specific parts of a document without invalidating the digest tree or cryptographic signatures that rely on it

https://blockchaincommons.github.io/WIPs-IETF-draft-envelope/draft-mcnally-envelope.html

In particular for this group, it supports triples where both the predicates and objects can be fully nested, i.e. "envelopes in envelopes". Part of the goal for this was to support annotation to allow for semantic clarity of both.

As I understand it, this approach comes closest to RDF* in approach, as it is more that a LPG (labeled property graph). Gordian Envelopes are, however, ONLY a data format, it does not specify or require semantic data.

We have a high-level overview of Gordian Envelops at:

https://www.blockchaincommons.com/introduction/Envelope-Intro/

A more engineering-level introduction at:

https://github.com/BlockchainCommons/Gordian/blob/master/Docs/Envelope-Tech-Intro.md

We have a video playlist starting with a 10m high-level introduction:

https://www.youtube.com/playlist?list=PLCkrqxOY1FbooYwJ7ZhpJ_QQk8Az1aCnG

We have a reference CLI implementation (written in Swift) available now, and some of our patrons have begun porting libraries to more languages like Kotlin, Typescript, Python, and Blockchain Commons is also committed to porting to Rust as funding allows. Let us know your needs!

For those of you who don't like videos, we have an annotated introduction to our CLI reference implementation that really demonstrates of the power of CBOR with Gordian Envelopes:

https://github.com/BlockchainCommons/envelope-cli-swift/blob/master/Transcripts/1-OVERVIEW-TRANSCRIPT.md

I'm seeking someone with a greater familiarity with RDF* architectures to identify if Gordian Envelopes might be useful to this community.

cc/ @wolfmcnally @selfissued @drummondreed

consider moving wiki work from GitHub-hosted to W3-hosted

Please forgive the built-in bias of this issue.

GitHub wiki is tragically under-featured. Major lacks that I run into start with these:

  • There is no "alert" mechanism associated with GitHub wiki pages, so the only way to discover that a wiki page has been updated is to visit the page.
  • There is no comparison across page versions, so you cannot see what changes have been made, for instance, since your last visit, nor since the last edit you know you saw, nor between this version and the previous, etc.

I have not yet encountered a feature that GitHub Wiki has that other Wikis lack.

Historically, all W3 WGs (and various other W3 entities) were automatically (whether by human or bot, I don't know) assigned a homepage within the overarching W3 Wiki, which is a fully-fledged wiki, which does provide all the things that the GitHub wiki fails to provide.

I strongly advise and request that we consider moving the RDF-star wiki work from the GitHub wiki to the W3 wiki.

No activity (nor even README) since WG approval in August

This repo needs to be kicked off with a README, CODEOWNERS, etc., and to be added to RDF-star WG Tools.

RDF-star WG meetings need to be added to the W3 Calendar.

We are chartered 2022-08-29 thru 2024-08-28, and we've already burned 1.5 months in silence, contrary to the Charter Timeline.

Also, somehow we only have 11 official WG participants (from only 7 organizations) for something that appeared to have significantly more interest (though about the same number of active concall attendees) while it was in CG. Extra strange, the second chair listed on the charter is not listed as a WG participant!

Convert SPARQL specs to ReSpec

This issue is for discussion and tracking work to convert SPARQL 1.1 specifications to ReSpec (or decide not to convert a spec).

They are all mentioned in the RDF-star charter.

Many of the specs were written in XML, to produce HTML via a W3C XSLT pipeline.

This means that while the HTML is "not pretty", it is quite regular.
Using HTML tidy produces HTML that is better for editing.

Hopefully, a basic bulk conversion can be done by automation.

Proposal: rename errata-related labels in all repositories

All the labels in our multiple repositories have been inherited from other W3C repos, because many of them are common and have meaning outside the repos (e.g. labels for horizontal reviews).

Among those labels are 3 which are used by the errata management page creaed by @iherman (see example here): ErratumRaised, Errata and Editorial.

The latest is super confusing, because people tend to use it to mark other issues or PRs with it, while other labels should be used (e.g. spec:editorial). See example in https://w3c.github.io/json-ld-syntax/errata/

I propose to:

  • rename these 3 labels with a prefix, following practice in other labels: errata:raised, errata:confirmed, errata:editorial;
  • adapt @iherman 's code when (if) we adopt it, to use these tags instead of the original ones.

This would make our list of labels more consistent and, hopefully, easier to use.

Editor assignments - Add here which spec you would like to work on

Duplicated or similar terms

Terms created via <dfn become exported and can be automatically reconciled by other specifications. Between RDF Concepts and Semantics a number of terms are created, and sometimes overlap.

  • It's possible to "define" a term but reference a term from another spec using data-cite. For example, <dfn data-cite="RDF12-CONCEPTS">RDF graph</dfn>, which styles the term in the defining spec, and allows simple references such as <a>RDF graph</a>.
  • Terms intended to be used locally can be declared to not be exported, for example <dfn class="no-export lint-ignore" data-dfn-for="rdf">invalid</dfn> (which comes from w3c/rdf-semantics#13).
  • Former terms can be demoted, but should have an anchor so that any existing references will continue to resolve. For example <dfn class="export">invalid</dfn><span id="dfn-invalid.x"><!-- obsolete term --></span>.

Given the potential range of updates, we should consider what to do about the following terms:

Many other terms in Semantics are exported but not used, at least in RDF Semantics (e.g., rdfs13. We might consider just making these "no-export" and just preserve the anchor.

Thus far, SPARQL doesn't export any terms, but probably will at some point.

CSS changes reduce readability of documents

Many working group documents have had CSS changes applied to them, for example w3c/rdf-turtle#20, which include code like:

    @media (max-width: 850px) {
        table th, table td { font-size: 12px; padding: 3px 4px;}
        table.ex th, table.ex td {overflow-x: scroll; max-width: 42vw !important;}

This change has the effect of reducing the side of text in tables when window width falls below a 850px, which occurs in many situations, not just on small devices. The reduced size makes it harder to read tables. In at least some cases there is no benefit to reducing the text size as the table can be rendered with no problems without reducing the text size.

Here is a screenshot showing the size difference.

Screenshot from 2023-05-20 08-12-28

Note how when the body text is small but easily readable the text in the table is less readable. There is no reason to reduce the table text size here as the table can be rendered at this width with no problems.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.