Сообщение Примеры для документации от 24.06.2016 4:14
Изменено 24.06.2016 4:14 IT
Прикрутил автоматизацию генерации примеров. Порядок действий:
— Создаём тест с примером. Можно для убедительности в каталоге Examples целевого пространства имён.
— Открываем шаблон Examples.tt в корне проекта и добавляем туда относительную ссылку на пример.
— Добавляем где нужно ссылку на код таким образом:
Готово.
При изменении примера не забываем перезапускать шаблон.
— Создаём тест с примером. Можно для убедительности в каталоге 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>
Готово.
При изменении примера не забываем перезапускать шаблон.
Примеры для документации
Прикрутил автоматизацию генерации примеров. Порядок действий:
— Создаём тест с примером в тестовом проекте. Можно для убедительности в каталоге Examples целевого пространства имён.
— Открываем шаблон Examples.tt в корне проекта и добавляем туда относительную ссылку на пример.
— Добавляем где нужно ссылку на код таким образом:
Готово.
При изменении примера не забываем перезапускать шаблон.
— Создаём тест с примером в тестовом проекте. Можно для убедительности в каталоге 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>
Готово.
При изменении примера не забываем перезапускать шаблон.