A discussion, in another thread, following a solution began here;
"But there is also such a thing as 'too much information'. People don't care how the function is declared, or how it's used in a class, a simple one-line example, along with the input and output of the function is perfectly enough in most cases.

Would you rather read a 200-page users manual that explains everything, from what platform the program was developed on and how, to how the code is written, did they write with both hands or not, just to find out how to use a 2MB utility? Or would you rather read a 2-page concise tutorial that brings you up to speed on everything you need to know in 30 seconds?"

What do you think?