Page MenuHomeSoftware Heritage

Clarify visits in SWHIDs
Closed, WontfixPublic

Description

The current SWHID specification mentions:

* **visit** : the *status of a full repository* containing the designated object, as a *snapshot*
  corresponding to a specific *visit* of that repository;

I find it confusing to call it visit if it's a snapshot PID. If it's because of the lack of visit identifiers, maybe we should fix that issue instead.

Event Timeline

vlorentz triaged this task as High priority.Apr 30 2020, 10:56 AM
vlorentz created this task.

We considered snapshot vs visit when choosing the qualifier name, and we settled with visit, as it conveys the idea that a repository snapshot is taken when a visit is performed (not necessarily through the same origin).

I agree that turning visit key into a snapshot one is less confusing.

Plus numerous visits of a same origin can point to the same snapshot so the confusion here.

I hear your concerns, but the discussion already took place and we have now already 2 published articles out there using visit, plus documentation shared that uses this new terminology.
So, no, we cannot change this now.

anlambert closed this task as Wontfix.Apr 30 2020, 12:31 PM
anlambert claimed this task.

Alright, closing this then.