documentation does not describe the importance of the remotes/ directory

[karenetheridge]

trafficstars

The remotes/ directory, located in the tests/ directory (two directories up from the main test content), contains additional resources which some tests reference directly using a base uri http://localhost:1234. This directory's existence, and its use in reference tests, is not described anywhere.

Since the spec does not require that an implementation has to be able to access the local filesystem or make network requests, the documentation should describe that either the contents of this directory should be made available to network requests at "http://localhost:1234", OR that all files under this directory (recursively) should be made known to the implementation using identifiers using that base URI so they can be later used by $refs.