Дмитрий Назаров, Владимир Шуляк: "Правильно готовим API-документацию в Python-проекте, используя RAML"
Правильно готовим API-документацию в Python-проекте, используя RAML
— Роль существующих систем документации API (Swagger, RAML, Apiary, ..) и их возможности. Какая из них подойдёт под ваш проект
— Почему мы выбирали RAML на нескольких своих проектах. Какие проблемы решило введение документации по API (и какие добавило)
— Как это всё выглядит и ощущается на практике (в демо-проекте и в продакшне)
— Сопутствующий инструментарий
— Сделанные выводы и дальнейшие мысли на эту тему.
Дмитрий Назаров
Россия. Санкт-Петербург
Software Engineer
Charge Software
Увлечённый своим ремеслом разработчик, прикладной математик по образованию. Сейчас пишу бэкэнд облака на третьем питоне и торнадо в charge.auto.
Владимир Шуляк
Россия. Санкт-Петербург
CTO
Create
CTO @ Create, веду команду, пишу код. Кофаундер нескольких стартапов в прошлом. Энтузиаст простой линейной регрессии.
ITMO, TechPeaks and Mind The Bridge SF Alumnus. #juniordevforlife