Generate org-wide diagram of software components and their interconnections

[PeterBowman]

There is a pressing need to improve documentation for newcomers (but not only) in such a manner that the most important components would be accessible at first glance. In fact, people want to find and understand what is more relevant to their work without wasting time by first digging in our repos.

In a parallel train of thought, we would like to embrace a how-to approach (e.g. "how do I make TEO walk?") and develop a knowledge base of available and future information. These concerns first arised with regard to TEO and its dedicated developer-manual (so far the only one we have, at least with such detail), but we'd like to make it global. In short, a rather complex and lengthy diagram would result from this, somewhat resembling what is depicted in roboticslab-uc3m/kinematics-dynamics#123. Then, a posted could be generated and printed (see also #32).

[PeterBowman]

BTW perhaps the yarpviz utility might be of use here to generate a diagram of port connections.