Здравствуйте, IT, Вы писали:

IT>Прикрутил автоматизацию генерации примеров.

Автоматизация, как оказалось, без надобности, все уже есть искаропки в sandcastle. Достаточно в коммент просто добавить тепг такого вида:

<code source="Main\tests\Mapping\Examples\MapTests.cs" lang="C#"/>

Путь к исходнику относительно корня репозитория. lang="C#" обязательно, если нужна подсветка синтаксиса на гитхабе.
И еще один момент — на гитхабе ширина дырки для кода — 91 символ. Соответственно нужно форматировать исходник чтобы скроллбар не вылазил.

UPD: Еще один хинт. Если нужно взять в качестве примера только часть исходника, то эту часть можно отделить регионом, а потом имя региона указать в теге code в атрибуте region.

Прикрутил автоматизацию генерации примеров. Порядок действий:

— Создаём тест с примером в тестовом проекте. Можно для убедительности в каталоге Examples целевого пространства имён.
— Открываем шаблон Examples.tt в корне проекта и добавляем туда относительную ссылку на пример.
— Добавляем где нужно ссылку на код таким образом:

    /// <example>
    /// This example shows how to explicitly convert one value to another.
    /// <include file='..\Examples.xml' path='doc/Example[@name="Mapping\Examples\MapMemberTests.cs"]/*'/>
    /// </example>

Готово.

При изменении примера не забываем перезапускать шаблон.