This doc has a really bad title - it should at least be "Overlapping IPs"
There is also an ascii diagram that looks pretty broken on this page.
Also, do we even need this document? Would this be better as a FAQ?
e.g
### Does Calico support overlapping IP addresses?
No, Calico doesn't allow you to use overlapping IP ranges. However, it could be possible to use 464XLAT to do this if it were so required. Modern orchestrators like Kubernetes use Service loadbalancers and DNS to abstract workload IP addresses from the application, so in most cases this isn't necessary.
http://docs.projectcalico.org/v2.0/reference/advanced/overlap-ips
This doc has a really bad title - it should at least be "Overlapping IPs"
There is also an ascii diagram that looks pretty broken on this page.
Also, do we even need this document? Would this be better as a FAQ?
e.g