Кстати про «дешевше и проще»

Если пользователи вашей документации все внутренние, можно их попросить подключить сетевой диск (хоть и тот же Google Drive) и закидывать файлы туда, чтобы сайт как локальная справка открывался 🙃

и когда техпису говорят: «вот тебе домен, сделай тут документацию и не создавай проблем», то гораздо проще пойти именно по ручному пути виртуалки с nginx.

Достаточно посмотреть на то, сколько дней у толкового программиста уйдет на то, чтобы сделать сертификаты в каком-нибудь кубере или на то, сколько времени выяснять в каких регионах AWS умеет выписывать сертификаты

Амазон не проще для начинающих. Он позволяет автоматизировать вещи и сократить количество админов, но речь идет о том, что он поможет сократить их с 10 до 1, а не до нуля

вот я так понял, что тулза, которую пилят знакомые, как раз автоматизирует сертификаты и прочее

(Но я не специалист, мог понять неправильно)

О, а ведь Plesk же это всё должен уметь?

Plesk это всё отлично умеет для виртуалки или железного сервера, ага. Насчёт облаков точно не знаю )

тут, конечно, слегка орнул. у нас просто половина офиса админов, человек 100 как минимум, так что да, в AWS мы могём :)

Вот например, я хочу чтобы тестовые версии доки куда-то деплоились. Т.е. под фичеветку или пуллреквест создавалось окружение, в котором поднималась копия сайта или его части. А когда не нужно — удалялось.

Всякие GH Pages это не поддерживают. Есть в readthedocs, но он только для Sphinx и без своих редиректов. Можно на одном большом сервере по папкам раскладывать разные версии доки и конфиги nginx —  я такую штуку делал, но это неудобно и не повторяет инфраструктуру на проде.

Поднимать в облаке докер-контейнер или хотя бы виртуалку выглядит отличным решением.

Это сейчас был практически каминг-аут. Да, мы не деплоим доки на тестовое окружение, пока не сделали. Только на исходник смотрим в пуллреквесте. ¯\_(ツ)_/¯

😱

вопрос:
чтобы в plantuml+graphviz надо в теорию графов?

Если контрибьютить в код, то лучше бы понимать основы. А так-то нет, не надо. Ты же можешь на листе бумаги нарисовать схему со стрелками.

Да, Ник, это шутка была )
Вызванная тем, что бес в ребро...Вспоминаю молодость. Решаю задачки ОГЭ, ЕГЭ, олимпиадные. Ну и проходится вспоминать теорию.
На самом деле, в том же graphviz заложена база из теории графов, например, гомеоморфные несводимые деревья и т.п.

> бес в ребро
седина в вершину

собственно, про редиректы:

> Getting a 404 on a documentation site is an abrupt end to a learning experience. GitHub’s docs team makes a commitment to prevent 404s when content files get renamed or moved around. There are a number of ways we support 20,000+ redirects in the codebase, and they can get complex.

https://github.blog/2020-07-02-how-we-launched-docs-github-com/

кстати. сама по себе поддержка функции редиректа ещё не делает сайт/сетап динамическим. редирект можно и статически поддерживать

@Lananovikova рад шо зашло про ирбнб 8)

Вообще зашло я ещё нашла несколько форков