I've been thinking of writing a documentation example which's purpose is to prove/confirm a certain statement, but I'm unsure if this is considered "acceptable" (even after reading the FAQ) or is what the examples should be used for.
Basically what I'm talking about are these kinds of examples:
- Why X is/isn't required to perform Y
- Why X should be used instead of Y
- Why X should/shouldn't be used...
- ...at all
- ...in the case of Y
- (and so on)
The first one is what my specific example would be about at the moment, but I'm curious about the others too...
So: Is it acceptable to write these kinds of documentation examples, or is there a better way of proving a statement or providing a good point?
EDIT:
In addition to the above, is it considered acceptable to include code from Microsoft's Reference Source in order to prove your point?