Page MenuHomeSoftware Heritage

Clarify visits in SWHIDs
Closed, MigratedEdits Locked

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 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 claimed this task.

Alright, closing this then.