-
-
Notifications
You must be signed in to change notification settings - Fork 860
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
Suggestion: difference between verb remove
and delete
#74
Comments
Hey, @SevenOutman. Thank you for your kinds words! I absolutely love your example and I think it should make it to the public guideline. The |
Sure. So glad I can help :) |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Hi Artem, thanks for this cheatsheet and the A/HC/LC pattern!
I still find it bit ambiguous for
remove
anddelete
when talking about relations instead of entities. I preferremove
being used on a relation, e.g.remove
a member from a team. But the termdelete
still makes sense if explained as "erases the relation from the realms of existence.".So I'd suggest explaining the difference between
remove
anddelete
by looking at their opposite actions -add
andcreate
. I find the key difference betweenadd
andcreate
is thatadd
needs a destination whilecreate
requires no destination. Readers can get confused when they find something can be eitherremoved
ordeleted
from somewhere, but they will then realize that it can only beadded
notcreated
to somewhere.Take the team member relation as an example, I can
add
a member to a team but cannot "create
a member to a team", thusremove
is used instead ofdelete
.The text was updated successfully, but these errors were encountered: