Hi,

My colleague and I are having some difficulty finding the information we need 
in the docs.
For example, the 
"terminology<http://docs.openvswitch.org/en/latest/faq/terminology/>" page has 
only 2 entries.

Could someone please explain the following things, so that I can add them to 
the docs?


*        What is the full list of possible types for a port? I know of 
dpdkvhostuserclient, dpdkvhostuser and internal. What are the other types?

*        Every bridge example I've seen has `datapath_type=netdev`. What other 
datapath_types are there?

*        How is the development process supposed to work? The site has a "fork 
on github" button, but this 
page<http://docs.openvswitch.org/en/latest/internals/contributing/submitting-patches/>
 says to send patches via email, but it also says that Github submission are 
the right way.

*        Where are logs saved? The docs don't say. After looking around I've 
found that today it is /usr/local/var/log/openvswitch, but yesterday it was 
/var/log/openvswitch . Why does it choose one of those locations over the other?

*        The "Basic configuration FAQ" talks about "access ports". What is an 
"access port"? How does it differ from other kinds of ports?

Other documentation improvement ideas:

*        There are two entries for `ovsdb` on this 
page<http://docs.openvswitch.org/en/latest/ref/>. They should be merged or 
relabelled uniquely.

*        High level documents like Why 
OVS<https://github.com/openvswitch/ovs/blob/master/Documentation/intro/why-ovs.rst>
 talk about accounting and visibility, but the docs provide almost no 
instructions on how to actually get statistics out of OVS. There should be a 
FAQ or guide about how to find out stats. E.g. I'm trying to find out what the 
bottleneck in my system is, and nothing in the docs helps me find that out.

*        The "Basic configuration FAQ" should have a more basic example,

*        The logo up the top of the readthedocs page links to 
https://openvswitch.org/ instead of https://www.openvswitch.org/ . 
Consequently, the user is presented with a full page certificate error

Thanks,


Matthew Davis
Technical Specialist
Telstra | Product Strategy & Innovation - Telstra Labs | Programmable 
Infrastructure
[email protected]<mailto:[email protected]>


_______________________________________________
discuss mailing list
[email protected]
https://mail.openvswitch.org/mailman/listinfo/ovs-discuss

Reply via email to