Recommend snippet syntax

styleguide/template.md

@@ -202,7 +202,35 @@ You can use a [Markdown table generator tool](http://www.tablesgenerator.com/mar
 
 ## Code
 
-### Code blocks with language identifier
+The best way to include code is to include snippets from a working sample. Create your
+sample following the instructions in the [contributing guide](../CONTRIBUTING.md#contributing-to-samples).
+
+You can include the code using include syntax:
+
+```
+[!code-csharp[<title>](<pathToFile>#<RegionName)]
+```
+
+The example above shows C# syntax, but other languages are supported.
+Use `code-fsharp` for F# samples; use `code-vbnet` for Visual Basic samples.
+Any language supported by [highlight.js](http://highlightjs.readthedocs.io/en/latest/css-classes-reference.html#language-names-and-aliases)
+is supported. 
+
+The text you place for `<title>` shows up as a rollover on the text. The `<pathToFile>`
+is the path to the source file. The `<RegionName>` should be a region in your source
+code that should be included. Use the `#region` and `#endregion` preprocessor syntax
+to specify the region of code to include.
+
+For cases where regions don't work, you can specify the start and end of a region
+using a triple-slash comment and an XML element name. Finally, you can use line
+numbers: `#L1-L10` would include lines 1 through 10. We discourage line numbers
+because they are very brittle.
+
+Including snippets from full programs ensures that all code runs through our CI
+system. However, if you need to show something that causes compile time or
+runtime errors, you can use inline code blocks.
+
+### Inline code blocks with language identifier
 
 Use three backticks (\`\`\`) + a language ID to apply language-specific color coding to a code block. Here is the entire list of [GFM language IDs](https://github.com/jmm/gfm-lang-ids/wiki/GitHub-Flavored-Markdown-(GFM)-language-IDs).