projectcalico / calico

Cloud native networking and network security
https://docs.tigera.io/calico/latest/about/
Apache License 2.0
6.05k stars 1.35k forks source link

"overlap IPs" is broken, has a bad title #217

Closed caseydavenport closed 8 years ago

caseydavenport commented 8 years ago

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

### 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.
caseydavenport commented 8 years ago

@robbrockbank care to chime in with a yes/no on removing this doc and turning it into a FAQ?