Closed michielbdejong closed 9 months ago
@glpatcern since we're now talking about tagging a v2.0 at some point, maybe this is one thing to be aware of. In any case I think we can write down the spec in more detail than just the Swagger file with comments we have now (more like an IETF Internet Draft or a W3C spec)
Agreed. I started to tag a few issues I believe are worth discussing, and I was hesitant on this one - where my current understanding is that yes we do allow (and we need to) for side-effects though they are non standardized.
Yeah, we can at least document them as 'MAY' behaviours.
A little philosophical question I ran into while writing the test suite:
When Alice shares a resource with Bob, she cannot share it again. If she tries to share it a second time, her GUI will warn her 'Bob already has access'. But if Bob sent back a notification like
SHARE_DECLINED
orSHARE_REMOVED
the that will in practice usually have the side-effect that Alice can share the resource with Bob again.This suggests that either sharing with someone should be idempotent, or the notifications and their side-effects should be standardised.