Samples note: Use comments to describe what code does, not what you wish the code would do

Windows API design is samples-driven. This means that when a team proposes an API, we want them to demonstrate how to use that API with a sample code fragment. We do this so that we can evaluate the ergonomics of the API and see

Click here to read the article