Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Revert "Enable passing identifiers to ActionNetwork upsert_person() #876

Merged
merged 5 commits into from
Sep 21, 2023

Conversation

austinweisgrau
Copy link
Collaborator

@austinweisgrau austinweisgrau commented Aug 22, 2023

This reverts most of commit 77ead60 / PR #861

I got more details on the consequences of using an identifier that is not globally unique in ActionNetwork, and was warned by ActionNetwork support that the consequences can be severe. In a more intense way than is mentioned in the official documentation, I was strongly warned against using custom identifiers.

In the PR we merged, documentation on the identifiers feature reports that if an identifier is used that is not globally unique in ActionNetwork, it is simply ignored. However, AN support told me that updates may be made to both the new resource and whatever resource already exists in ActionNetwork that holds that identifier. This behavior may cause updates that violate expectations and it won't be transparent or reported back to the developer that those updates were made. Many users who use identifiers encounter issues of this kind, and for these reasons AN support strongly encourage folks not to use identifiers unless they really have to.

At WFP we are going to be retiring our use of identifiers, because of this feedback and we don't really need them. In general, it does make sense to me that this feature should, by design, be hard to use, so I think we should actually remove this feature from the ActionNetwork connector.

A note is added to the upsert_person() method explaining why identifiers are not included as an option in case a future developer starts to go down the same rabbit hole I have just traversed.

sharinetmc
sharinetmc previously approved these changes Sep 14, 2023
Copy link
Contributor

@sharinetmc sharinetmc left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Thank you for adding this, will def be super useful for future users!

Copy link
Contributor

@sharinetmc sharinetmc left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually, upon thinking about this further, I'm wondering if if this perhaps could be a breaking change due to the fact that perhaps other users may be using this param.

@sharinetmc sharinetmc dismissed their stale review September 14, 2023 13:58

this could perhaps be a breaking change

@austinweisgrau
Copy link
Collaborator Author

austinweisgrau commented Sep 14, 2023 via email

@sharinetmc
Copy link
Contributor

@austinweisgrau, good point, but I also did see that Ian has used the param for some recent parsons changes. @shaunagm, would you know what the best practices are for instances like this? Should I mark this as a breaking change and/or change the code Ian wrote or create an issue?

@sharinetmc sharinetmc added the bug fix Work type - fixes existing bug label Sep 14, 2023
@shaunagm
Copy link
Collaborator

Let's tag @IanRFerguson and see if reverting will cause any complications for him? Otherwise let's go ahead and revert.

This was included in the last release, so we definitely want highlight it in the release notes for the release @KasiaHinkson is making next week. I'm not sure if it makes sense to release another major version just for this, though, or whether to keep it a minor release and just message very clearly that we are removing this thing. @Jason94, any thoughts?

@IanRFerguson
Copy link
Contributor

Let's tag @IanRFerguson and see if reverting will cause any complications for him? Otherwise let's go ahead and revert.

This was included in the last release, so we definitely want highlight it in the release notes for the release @KasiaHinkson is making next week. I'm not sure if it makes sense to release another major version just for this, though, or whether to keep it a minor release and just message very clearly that we are removing this thing. @Jason94, any thoughts?

thanks for checking y'all - is this going to revert changes to Parsons globally, or just for the ActionNetwork connector? if the latter is true then by all means

@sharinetmc sharinetmc merged commit 1edd75f into move-coop:main Sep 21, 2023
5 checks passed
@austinweisgrau austinweisgrau deleted the actionnetwork_identifiers branch December 6, 2023 00:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug fix Work type - fixes existing bug
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants