Add note after testing with deeper paths 
Add note after testing with deeper paths 

swagger-ui doesn't accept something like #/references/hotels/ChangeRequest and the structure:

{"references": {
  "hotels": {
    "ChangeRequest": { ... }
  }
}

... so we'll still with #/references/hotels:ChangeRequest.
bmabey/rook,roblally/rook,clyfe/rook