OEP-32 has been superseded and should be updated

[e0d]

The guidance for external ids in OEP-32 is currently incorrect and that OEP has been superseded by this ADR.

The OEP needs a significant rework.

[robrap]

Do you think the guidance is still correct for ids internal to the platform, and this is just about correcting guidance for external ids?

[e0d]

The ADR only covers the case of external IDs. So, job one would be correcting that.

My preference would be that auto increment database IDs were not used as identifiers, but that's a much bigger, breaking, change I believe.

[robrap]

I agree with your preference, but the point of the OEP was to codify what to use, given the reality of our situation. Better than using user id in some cases, and username in other cases, as was happening.

[sarina]

@robrap @e0d - is OEP-32 completely incorrect and should be marked as Obsolete, or is it simply that parts need updating?

[robrap]

It is partially correct. It is valid for internal ids, and invalid for external ids. I'm not sure if there are legacy exceptions to the external ids case that do use this same internal id.

[sarina]

Thanks. Assuming #586 passes, I will mark this OEP as Needs Revision and point to this thread.