My complaints were with the doc's
eg the cloth (which I added a week or 2 ago)
http://docs.unity3d.com/Manual/class-InteractiveCloth.html
the doc's tell you next to nothing, eg
Bending Stiffness Bending stiffness of the cloth.
Stretching Stiffness Stretching Stiffness of the cloth. etc
well thats useful as I would of never known that
How should documention be?
See Microsoft,google,mozilla,unreal,apple etc etc
Unity's doc's are chiefly expanded
http://en.wikipedia.org/wiki/Doxygenfiles
btw I ended up writing my own cloth routine, it was quicker