Pinging Paul Angus, who can surely answer these questions. We can then edit the docs.
> On Sep 29, 2015, at 7:03 AM, Ron Wheeler <rwhee...@artifact-software.com> > wrote: > > http://docs.cloudstack.apache.org/en/master/concepts.html#what-is-apache-cloudstack > > In the opening paragraph of About Physical Networks" it says > "The network corresponds to a NIC on the hypervisor host." > > In Basic Zone Network Traffic Types it says that there is only one physical > network in the zone but later on in the middle of discussing the various > traffic types there is a note > "We strongly recommend the use of separate NICs for management traffic and > guest traffic". > There is no reason given for this statement. > No suggestion about what tradeoff is being made if you go with a single NIC. > Is it performance or security concerns that prompts this? > > It might be helpful to describe what is meant by a single physical network > with multiple NICs. > > The note itself appears to be out of place since it is in the middle of some > definitions rather that in a discussion block. > It also looks like it applies to Advanced Networks but is missing in that > section. > > "CIDR of the pod" is used without any description of what this is and how it > gets setup. > Might be helpful to add a sentence or two about this. It seems important. > > "guest virtual router" is another concept that seems important but has no > definition or discussion. > > Ron > > -- > Ron Wheeler > President > Artifact Software Inc > email: rwhee...@artifact-software.com > skype: ronaldmwheeler > phone: 866-970-2435, ext 102 >