>I wonder if it makes any sense to deal with the issue the same way MS does it? In other words, write here in the same style that MS writes in the professional documentation that we have for the products that we use... No, wait a second, then we wouldn't be able to understand each other at all.

:-) Actually, we would understand it. We'd think everything will just fall together, easy as pie all the while making complete sense. Then after you code it and run it you find out its completely different than what you wanted or doesn't plan work at all....