Note relative URL-reference resolution ambiguity

This explicitly lists out the cases and notes which ones were
(as far as we can recall) intended to behave like `$ref`, but
could be reasonably read to behave like API URLs.