QoS and Linux documentation

I have recently came across a need for creating some Traffic Control rules for a commercial project. I hoped that Linux has a stable and comprehensive documentation. But it turned into a race for any information. It seems that iproute2 package which contains tc tool is not yet well documented. If it is documented at all. I have never seen such a poor documentation for any of Linux parts. There are two parts missing first documentation of how it all works. Some studies exist but most of them are outdated papers or diving just into some parts of the QoS problem. And the second description of control of the QoS via the tc program. I tried hard to get any information and I plan to issue some own to help.