@factorized вроде у тебя был middleman?

Расскажите, какая задача?

Задача — найти инструмент для красивой API документации. Наткнулась на вот такой проект https://github.com/lord/slate, выглядит красиво, но смущает генератор на ruby, и что "нативная" совместимость только с github pages. Было бы здорово узнать, есть ли успешные кейсы применения middleman на реальных проектах с публикацией документации, например, через docker контейнер. Потому что если нет, то скорее всего будет нецелесообразно лезть разбиираться  🙂

Swagger?

swagger уже есть

Hanna вы его хотите заменить или дополнить?

дополнить!

Про публикацию через docker: это отдельная задача, она не связана с тем, какой инструмент вы используете. Грубо говоря, любой генератор статических сайтов выдаёт вам файлы HTML+CSS+JS. Потом вы берёте стандартный образ nginx:latest, добавляете в него файлы и запечатываете в новый образ. Всё, документация в докере готова.

@Nick_Volynkin спасибо за помощь! может, и стоит попробовать)

A расскажите, пожалуйста, подробней. Чем вы хотите дополнить swagger?

Вы хотите кроме API reference ещё написать про смысл и то как использовать API? Tutorials, quickstart guide, вот это всё?

да, я на нем статические сайты делаю (documentat.io тоже на нем сделан, кстати), но паблишу всё на github pages

вообще какой-то привязки к github pages у него нет, он на выход отдает просто пачку HTML и статических ассетов (css, js)

@factorized а ты деплоишь через ветку gh-pages, так?

это можно публиковать куда угодно, хоть на S3, хоть в докер-контейнер с nginx-ом заворачивать

да

хоть по старинке на физический железячный сервер выложить:)

да, да

@factorized спасибо!

тогда предлагаю вам выбрать SSG по таким критериям:
— написан на языке, на котором у вас есть разработчики. Вот Руби вам именно этим не подходит, да?
— из коробки есть тема (шаблон) оформления, которая вам нравится