ensure that instances of IpAddress are correctly evaluated
fix doc comment
ensure local resources are always first