Be more robust in relation to repsonse definitions

Also create correct URLs for documentation