Какие теги XML-комментариев следует использовать на странице справки Microsoft ASP.NET Web API, которую следует использовать для методов контроллера?

Я пытаюсь создать документацию по API для веб-службы RESTful с помощью страницы справки Microsoft ASP.NET Web API 2.2 5.2.3. Похоже, содержимое <summary> а также <param> элементы включаются в документацию, но <remarks> раздел полностью игнорируется, и где бы я ожидал описание <returns>Я вижу дубликат <summary>, Я не смог найти ни одной статьи, объясняющей, какие XML-теги комментариев поддерживает страница справки (или чем комментирование контроллеров отличается от комментирования обычного кода). Мне интересно, может ли кто-нибудь поделиться какими-либо указателями, в частности, какие теги можно использовать, как ссылаться на другие страницы и т. Д.

0 ответов

Другие вопросы по тегам