To ensure the code snippets in our docs remain up to date, they should use tested code. Two possible sources for tested code are snippets from tests and from samples.
In some cases, this will mean changing documentation snippets and surrounding text to use an existing test or sample. In other cases, it will mean adding a test or sample project.
Instead of copying code into a documentation snippet, it should use an include.