Suggestion: difference between verb remove and delete

[SevenOutman]

Hi Artem, thanks for this cheatsheet and the A/HC/LC pattern!

I still find it bit ambiguous for remove and delete when talking about relations instead of entities. I prefer remove being used on a relation, e.g. remove a member from a team. But the term delete still makes sense if explained as "erases the relation from the realms of existence.".

So I'd suggest explaining the difference between remove and delete by looking at their opposite actions - add and create. I find the key difference between add and create is that add needs a destination while create requires no destination. Readers can get confused when they find something can be either removed or deleted from somewhere, but they will then realize that it can only be added not created 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", thus remove is used instead of delete.

[kettanaito]

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 add/create analogy in comparison to remove/delete is fantastic. Please, would you be interested in opening a pull request with this suggestion?

[SevenOutman]

Sure. So glad I can help :)