Warren Parad

Please don't make the name short to try to be funny. Descriptive names are so much better, what's wrong withe `tinysearch`?

> > what's wrong with tinysearch? > > @wparad I mentioned some reasons in the first comment. > > > * Not the the most creative of names. > >...

What makes us think this is backwards incompatible? before we were throwing an unnecessary error and now we handle it appropriately? Seeing as we are using javascript, it's natural to...

minor version bump makes sense, I totally get that. It was just confusing to say "it isn't backwards compatible" since `string | object` is backwards compatible to `string` right? No...

Which subclasses do we have that would be impacted?

Do you mean widening a function signature parameter type versus a function's signature return type? If you are a making a different distinction, I'm not getting it, a method and...

So, I think this is a weird request. Something like, `because of the use of hypermedia, you would never need to know what all the API's look like, just the...

@dret, you bring up some interesting points. Most noteworthy I would add though is fundamentally hypermedia provides the mechanism for self-discoverable APIs. I have found [Google's similar thing](https://www.googleapis.com/discovery/v1/apis) with [instructions](https://developers.google.com/discovery/v1/reference/apis),...

Aren't full APIs discoverable from their documentation, I.e. your service wiki or client homepage/portal. Is that not what service owners are doing? Are some teams doing something that makes no...

Isn't the recommendation is always use link relations where appropriate? Especially type and self, others as it makes sense. I'm not sure how useful the ones in the rfc you...