Swagger
Документация является важной составляющей REST API – чем она удобнее и понятнее, тем меньше времени тратят разработчики, использующие ваше API. Хорошая документация упрощает жизнь всем – разработчикам/тестерам/клиентам. В докладе Павел расскажет про его опыт работы со Swagger – популярным подходом к спецификации REST API:
- про Сode First и Design First подходы к документации, какой лучше использовать в вашем случае;
- как сгенерировать документацию из ваших ASP.NET (Core) проектов;
- как сгенерировать код клиента/сервера по Swagger спецификации;
- где лучше всего хранить документацию;
- какие подводные камни вас могут подстерегать при работе со Swagger.
Доклад представил Павел Федотовский в рамках Встречи SpbDotNet №20.