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