Hacker News Reader

This kind of thing provides endless material for Raymond Chen's blog[1]. It also explains a lot of the insane backwards compatability that is still in Windows.

[1]http://blogs.msdn.com/b/oldnewthing/

Yes. All the time, if the name and signature are enough to tell you what it does and how to use it, which is normally considered a good thing.

The caller does indeed deserve whatever woes befall them, but sometimes the caller is loud enough, powerful enough, or prominent enough that you have to support them... even when they're bypassing your actual API and hitting your internal methods.

Not only will they (attempt to) use them, but they will decry your half-assed documentation, and be right to do so.

> The caller deserves whatever woes befall them.

Why?