Комментарии 9
Но не было бы лучше, если бы сам ваш Web API обеспечивал доступ к своей документации
Swagger UI, не?
+5
Я не считаю, что описанный мною подход — замена для Swagger UI или NSwag. Просто иногда требуется еще что-то кроме описания синтаксиса методов: какие-то общие идеи, концепции, лежащие в основе работы сервиса. Мне кажется, что написанные человеком документы в некоторых случаях лучше.
Но, конечно, каждый выбирает решение, лучше подходящее под его ситуацию.
Но, конечно, каждый выбирает решение, лучше подходящее под его ситуацию.
0
… было бы лучше, если бы Web API отдавал документацию, которая заведомо совместима с кодом.
0
Мои коллеги из компании Confirmit.
Эпично.
Скрин
Хотя может статья давно в песочнице лежит, что никаких коллег уж и нет.
А почему не NSwag и прочее подобное?
0
Зарегистрируйтесь на Хабре, чтобы оставить комментарий
Поддержка документации в ASP.NET Web API