Поддержка документации в ASP.NET Web API

[alexs0ff]

Но не было бы лучше, если бы сам ваш Web API обеспечивал доступ к своей документации

Swagger UI, не?

[iakimov]

Я не считаю, что описанный мною подход — замена для Swagger UI или NSwag. Просто иногда требуется еще что-то кроме описания синтаксиса методов: какие-то общие идеи, концепции, лежащие в основе работы сервиса. Мне кажется, что написанные человеком документы в некоторых случаях лучше.
Но, конечно, каждый выбирает решение, лучше подходящее под его ситуацию.

[lair]

… было бы лучше, если бы Web API отдавал документацию, которая заведомо совместима с кодом.

[lair]

и автосгенерированный код. Когда я знакомлюсь с API, мне кода не хочется, мне хочется примеров.

[lair]

Я ровно на это и намекал. Благо asp.net WebAPI это прекрасно умеет.

[dmitry_dvm]

Мои коллеги из компании Confirmit.

Эпично.

Скрин

Хотя может статья давно в песочнице лежит, что никаких коллег уж и нет.
А почему не NSwag и прочее подобное?

[iakimov]

Я считаю, что для некоторых случаев написанные человеком документы подходят лучше. Но, конечно, мое решение — не замена для NSwag и т.п. Так что каждый выбирает для себя.