# WG Meeting: 2023-08-15
## Agenda
- Versioning proposal
- Remove authorization scopes / URLs from SSF metadata
- Comments in ["Sub_id" PR](https://github.com/openid/sharedsignals/pull/82/files)
## Attendees
- Atul Tulshibagwale (SGNL)
- Asad Ali (Thales)
- Steve Venema (ForgeRock)
- Apoorva Deshpande (Okta)
- Tim Cappalli (Microsoft)
- Peter Travers (Beyond Identity)
- Mike Kiser (SailPoint)
- Phil Hunt (Independent ID)
## Notes
### Versioning Proposal
- How do we document what has changed between versions?
- We can tag releases on GitHub with the changes
- The tag should say which release version of the document it refers to.
- Typically handled in non-spec output (e.g. blog posts)
- Ideally every change has an associated GitHub issue, and we can just capture the list of issues that have been addressed.
- Breaking vs. Non-breaking changes
- We could have normative text that specifies implementers should ignore any unknown additional claims
- How do we ascertain compliance?
- Breaking should imply that an existing deployment would no longer work with a newer version
- Proposed wording: "Must ignore claims or attributes that are not understood"
- Is there some reference language we can borrow?
- There's an old BCP? In the IETF
- The JWT spec has text in it.
- We had discussions about document version / protocol version correlation
- We should not do this.
- A variation of the question is: As we're iterating on a version, what do we do in the interim
- All versions in the interim (before an approved version is released) reference a same version number
- We might want to title the doc "protocol versioning"
- What does it mean to change a dictionary (e.g. the set of events described in the CAEP spec)
- Any change to a dictionary is a protocol / schema revision
- How would a Receiver know which dictionary version is supported by the Transmitter?
- Phil: just do version by dictionary, but include in each URN
- Tim: agreed, then doc can match event versions
- Tim: matches current OIDF process of being in a spec
- Also need a versioning guide (or section) specifically for event dictionaries as they differ from protocol versions
- Steve: could also have the same event listed with different versions in metadata if Tx supports two versions of the dictionary
- Steve: What if only 1 event changes in a dictionary update?
- Phil: change them all for conveinance
- Need use cases for version changes of events vs dictionary
- Tim: one question is whether rev-ing a version of an event when it didn't change is as a bad thing
## Action Items
- [ ] Atul to incorporate text from the JWT spec for specifying what is backward compatibility. Get consensus and add it to the spec.
- [ ] Steve to write up use cases for event version changes
- [ ] All: review issue #95 before next call per Apoorva's request