AI #1522: Renaming recency last update date to recency last updated

[rileyjenk]

No description provided.

[gparker-at-sf]

Following TF3 discussion -- LGTM

[ijurica]

As part of PR #1533 (beyond 1.3 Consistency Review scope) we started working on Metadata Guidelines and Naming Convention.
Below is a summary relevant to the 1.3 Consistency scope of work, focusing on naming patterns for State Indicator and Timestamp properties.

Naming Convention Principles

• Use the Base + Suffix pattern for property names wherever possible.
• State Indicator properties indicate whether a specific condition is met or an event has occurred.
  → Use the <PastParticipleVerb> pattern for the suffix (e.g., Completed, Deprecated)
• Timestamp properties capture the point in time when a specific condition is met or an event has occurred.
  → Use the <PastParticipleVerb>At pattern for the suffix (e.g., CompletedAt, CreatedAt, LastUpdatedAt)

Here is an overview of our property suffixes for the so-called State Indicator and Timestamp properties:

Introduced In Version	Property Type/Category	Original	1.3 Consistency Minimum	1.3 Consistency Alternative	North Star (1.4)
1.3	State Indicator	Complete	Complete	Completed*	Completed*
before 1.3	State Indicator	Deprecated	Deprecated	Deprecated	Deprecated
1.3	Timestamp	LastUpdated, LastUpdateDate	LastUpdated*	LastUpdatedAt*	LastUpdatedAt*
before 1.3	Timestamp	CreationDate	CreationDate	CreationDate	CreatedAt*

* Asterisk indicates a required naming change.

---

Based on this, the 1.3 Consistency Review scope offers two options:

Option 1: Minimum

Ensure at least alignment among the three newly introduced Timestamp properties:

• Update RecencyLastUpdateDate to RecencyLastUpdated
• Rename this and other properties in a future release once the Naming Convention is agreed and in place.

Option 2: Alternative

Fully align all three newly introduced Timestamp properties and one newly introduced State Indicator property with the assumed naming convention:

• Update RecencyLastUpdateDate to RecencyLastUpdatedAt
• Update DatasetInstanceLastUpdated to DatasetInstanceLastUpdatedAt
• Update TimeSectorLastUpdated to TimeSectorLastUpdatedAt
• Update DatasetInstanceComplete to DatasetInstanceCompleted
• Update TimeSectorComplete to TimeSectorCompleted

---

Given the current scope, I agree we proceed with Option 1 for the 1.3 consistency review. That said, I intend to advocate for the North Star naming convention in 1.4, including revisiting and renaming even these newly introduced properties to align with the finalized guidelines. 🙂

[shawnalpay]

See recent comments.

[shawnalpay]

Recency.mdpp is being reworked as part of #1521, but I'm good with approving this one!

[jpradocueva]

Approved by the group without objections or abstentions during the October 30 Members’ call.