What does the hash values in §B.2 mean?

[iherman]

Appendix €B.2 include hash values for two vocabularies, namely the VCDM and the DI ones. However, it is unclear what these hash values really represent.

There is a reference to the media type, namely application/ld+json, which suggests that the hash values represent a particular serialization of the vocabulary, namely JSON-LD. But the vocabulary is published in three different formats (JSON-LD, Turtle, and HTML+RDFa) and, in general, there is no reason to use that particular serialization.

Wouldn't it be more appropriate to publish the canonical hash value of the underlying vocabulary dataset, as defined by the RDFC-1.0 algorithm, as defined by the RCH (upcoming) Recommendation?

[iherman]

The issue was discussed in a meeting on 2024-03-06

• no resolutions were taken

View the transcript

2.1. What does the hash values in §B.2 mean? (issue vc-data-model#1442)

See github issue vc-data-model#1442.

Michael Jones: oh, this is before PR, so we'll skip it for now.

Brent Zundel: 1442 is assigned to ivan.

Manu Sporny: just to provide some input.
… ivan asked about posting the canonical hash.
… what we want is for people to retrieve something from the Web, and pass it through a library to get the hash.
… telling people to have something special on hand to tell if the doc is valid is not what we want.
… using a format they can read, SHA it, and compare would be better.
… we could add hashes for every serialization, but that feels like a bit much.
… we do want to update our ReSpec extension to generate these hashes at publication time.

Ivan Herman: it was already clear back then that the hash is the representation of the JSON-LD of the vocabulary.

Manu Sporny: yes.

Ivan Herman: depending on conneg, you may get other formats.
… it's not clear enough that the hash is specifically for the application/ld+json representation.

Manu Sporny: I thought we had examples of how to recreate the hashes.

Ivan Herman: it's there, but it's still not clear.
… make it clear. should only be a few words.

Brent Zundel: currently this is assigned to you, ivan.

Ivan Herman: I can make a PR.

[iherman]

A PR has been raised in #1454; this issue can be closed if and when that PR is merged.

[iherman]

The issue was discussed in a meeting on 2024-03-13

• no resolutions were taken

View the transcript

4.5. What does the hash values in §B.2 mean? (issue vc-data-model#1442)

See github issue vc-data-model#1442.

See github pull request vc-data-model#1454.

Brent Zundel: there is a PR, positive review, changes from TallTed. Please review. Should be merged soon.

[iherman]

#1454 has been merged, this issue can be closed.