credential repository vs repository, and definitions in _1.2 Ecosystem Overview_ vs _2. Terminology_

[TallTed]

Originally posted by @TallTed in #1467 (comment)

We define repository but not credential repository. Bare repository is used 3 times in the text; credential repository is used 4 times. I think all occurrences of the bare repository should be changed to credential repository.

While investigating the above, I discovered that we have two competing definitions for holder (and several other things) — in 1.2 Ecosystem Overview (which I think should either point to the other section, or exactly duplicate the other definition) and 2. Terminology (which I think is meant to be authoritative).

Then, the definition of repository — "A program, such as a storage vault or personal verifiable credential wallet, that stores and protects access to holders' verifiable credentials." Can I not store a VC in a simple filesystem directory, that is on my personal storage device? I thought I could...

[msporny]

@TallTed wrote:

I think all occurrences of the bare repository should be changed to credential repository.

Agreed.

Can I not store a VC in a simple filesystem directory, that is on my personal storage device? I thought I could...

You can. I think we were presuming some functionality would have to exist for that thing (like digital signature capability), which is why we picked "program" before. Perhaps we should replace "A program" to "A location" and include "file system", "database", and/or "website" as a place that could be a credential repository?

[iherman]

The issue was discussed in a meeting on 2024-05-01

• no resolutions were taken

View the transcript

3.2. credential repository vs repository, and definitions in 1.2 Ecosystem Overview vs 2. Terminology (issue vc-data-model#1475)

See github issue vc-data-model#1475.

Brent Zundel: Ted, could you jump on the queue and walk us through this -- and to the group, who would be willing to be assigned to make it happen?

Ted Thibodeau Jr.: One item here is a quick search and replace PR, another is rephrasing a sentence, the third is rationalizing some competing definition of things. Ecosystem and terminology do the same thing partly -- but with different definitions.
… That one I hadn't resolved at all. That's not in the comment from Manu either.

Brent Zundel: Is this something you could begin to address in a PR?

Ted Thibodeau Jr.: I don't think it needs discussion, just heads down.

Brent Zundel: Can I assign you?

Ted Thibodeau Jr.: Sure.

[TallTed]

While investigating the above, I discovered that we have two competing definitions for holder (and several other things) — in 1.2 Ecosystem Overview (which I think should either point to the other section, or exactly duplicate the other definition) and 2. Terminology (which I think is meant to be authoritative).

I'm sure the definitions in 1.2 Ecosystem Overview and 2. Terminology should first be synchronized. I will address that, once I know how to handle what's below.

Then, should 1.2 Ecosystem Overview continue to hold the full wording of these definitions (which must be thenceforth kept in sync with 2. Terminology), or should there be some link from the terms used in 1.2 Ecosystem Overview to their definitions in 2. Terminology? Assuming the latter, what markup should be used in 1.2 Ecosystem Overview? (Hoping @msporny has a quick and easy answer, here.)

[msporny]

Assuming the latter, what markup should be used in 1.2 Ecosystem Overview? (Hoping @msporny has a quick and easy answer, here.)

Use the <dfn>term</dfn> syntax in Terminology and the[= term =]` syntax when using the term in Ecosystem Overview. Did that answer your question, @TallTed?

[msporny]

We define repository but not credential repository. Bare repository is used 3 times in the text; credential repository is used 4 times. I think all occurrences of the bare repository should be changed to credential repository.

Fixed in 29f431d.

Then, the definition of repository — "A program, such as a storage vault or personal verifiable credential wallet, that stores and protects access to holders' verifiable credentials." Can I not store a VC in a simple filesystem directory, that is on my personal storage device? I thought I could...

Fixed in 27d2761.

While investigating the above, I discovered that we have two competing definitions for holder (and several other things) — in 1.2 Ecosystem Overview (which I think should either point to the other section, or exactly duplicate the other definition) and 2. Terminology (which I think is meant to be authoritative).

Fixed in 9ecd2c1.

[msporny]

The first fix was done in a reviewed PR. The other two fixes were purely editorial, literally just adding uncontroversial text or moving existing text around; I just committed those two to main.

This issue has been addressed, if you disagree, please re-open the issue.