Readthedocs можно самому хостить

Это понятно, но мне нужно что-то типо netlify скорее...

Amazon S3?

И сверху закрыть CDN'ом

докер+nginx с запиленым CD работает на ура

Ну вот да ( )

Всем приветики. Вопрос к тем, кто занимается описанием API и использует Swagger.
Разрабы генерируют мне swagger file. Я там всё красиво пишу и редактирую, добавляю-обновляю и заливаю на дев. портал.
Проблема в том, что в коде остаются старые, некрасивые описания.
Вопрос: каким образом сделать так, чтобы и в код попадали описания, отредактированные мною?
А) Может быть, мне стоит править описание API методов прямо в коде и уже потом генерировать swagger file?
Б) Или же можно каким-то образом залить swagger file, отредактированный мною, обратно в код?
В) Есть ещё какой-то подход?

A)

встречный вопрос, а зачем оставлять старое описание?

Спасибо! Я тоже так думала, но нужно было убедиться в правильности моего предположения.

+1

В том то и смысл, что я не хочу оставлять старые описания. Но изначально разрабы не хотели пускать меня в код. Генерировали мне swagger file, я его редактировала — и разрабы чувствовали себя в безопасности 😂

Но в коде оставались старые описания.

A

Прошу прощения, но похоже разрабы просто пытались от вас отмахнуться :(

если вы работаете в гите, то там можно поддерживать версионность

В нашем случае, я пишу доки не в коде, а в отдельной папке для сваггера, которая повторяет структуру source файлов. Потом есть мидлварь, которая натравливается на индекс файл сваггера, в который включены все файлы и она генерит финальный swagger json, который потом используется в доке

Так и было, думаю. Плюс, они ссылаются на то, что у них мало времени на проверку изменений, который я потенциально буду делать.

Сначала писать спеку, а что бы разрабы по ней уже писали код?