Lorna Jane Mitchell

I'd like to contribute the Museum API to the list. It was created specifically for learning purposes, and while I expect us to add some more features and update it,...

Yes but I don't think I have enough rights in both locations. @darrelmiller can you move this to Overlays with a note about why? I think this list would be...

I think there's a translation/localisation use case too - making an API description available with description fields in another language.

@kevinswiber Thanks for the approval, but do you have any thoughts on how to version this in a way that won't confuse existing users? That's what got me really stuck.

Without a pull request description, this took me a while to understand. What we're saying is that we should add these fields, conditional on them not being there already? So...

See also #32 where we have commandeered the add syntax to mean something else. I'm still not sure what this operation should be called.

This is is a great question, and I think we don't have this use case covered. The only options are to `remove` or to` update` where `update` is described like...

@handrews Thanks for the link, I will dig into it! Honestly, I've no idea about anything that might have previously been considered or discussed, I'm not an overlays spec contributor,...

So RFC 6902 does have `replace` - our `remove` seems quite similar to theirs, and our `update` matches their `add` from what I can tell. Let's keep this open and...

I think there's grounds for depending on an existing standard, Henry suggested that JSON Patch has similar operations (I think it postdates the original overlays draft) - a side benefit...