Комментарии 9
Но не было бы лучше, если бы сам ваш Web API обеспечивал доступ к своей документации
Swagger UI, не?
+5
Я не считаю, что описанный мною подход — замена для Swagger UI или NSwag. Просто иногда требуется еще что-то кроме описания синтаксиса методов: какие-то общие идеи, концепции, лежащие в основе работы сервиса. Мне кажется, что написанные человеком документы в некоторых случаях лучше.
Но, конечно, каждый выбирает решение, лучше подходящее под его ситуацию.
Но, конечно, каждый выбирает решение, лучше подходящее под его ситуацию.
0
… было бы лучше, если бы Web API отдавал документацию, которая заведомо совместима с кодом.
0
Мои коллеги из компании Confirmit.
Эпично.
Скрин![image](https://habrastorage.org/r/w1560/webt/oy/w1/fj/oyw1fjxe-uogorx8ka2oyxpxtgo.png)
![image](https://habrastorage.org/webt/oy/w1/fj/oyw1fjxe-uogorx8ka2oyxpxtgo.png)
Хотя может статья давно в песочнице лежит, что никаких коллег уж и нет.
А почему не NSwag и прочее подобное?
0
Зарегистрируйтесь на Хабре, чтобы оставить комментарий
Поддержка документации в ASP.NET Web API