OVN has some nice debugging tools. While they have good manpages, discovering the tools' existence, and understanding all their possible options is difficult. Having a tutorial document in the Documentation/ directory of the OVN source would be very helpful. If this document is also posted to ovn.org, then this gives an easily-linked document and makes it more easily discoverable.
We discussed this issue today during our OVN meeting. For context, this issue got created after a user of OVN was told by a developer that the developer had used ovn-detrace to help debug an issue. The user said "oh, I didn't know that ovn-detrace existed!" and so we decided that having some sort of tutorial pointing out debugging tools was a good idea. There are now multiple resources for OVN debugging that exist outside of the OVN project that do a good job of explaining tools. However, there still is not a document in the source that directs people to specific tools for debugging certain types of issues. So this issue currently exists to create such a document in the documentation directory of OVN. It was also brought up that we might want to create testsuite tests that verify the integrity of this particular document, but as of this moment, that is not within the scope of this particular issue.