Я бы тоже не отказался

а что вы понимаете под «работой с»? просто выполнить плейбук не так уж и сложно и описывается очень коротко

Я не работал с Ansible, но видел, что некоторые репозитории на гитхабе, где есть такие книги, содержат короткую документацию по работе: как установить и запустить среду исполнения, как выполнить сам плейбук, как его настроить, если надо.

Хочется понять, как обычно описывается работа с этими плейбуками. Цель: сделать конечное решение для тех, кому пойдёт плейбук.

Исходные таковы что тот, кто будет его запускать, никогда про Ansible не слышал и отдельно про него читать не будет.

у меня есть образец инструкции, но ориентированный на людей, которые в принципе понимают, как работает Ansible, поэтому, видимо, вам не подойдёт.

на старой работе были

я спрошу

Если можете скинуть, буду рад. Нужно понять приятные, работающие, подходы.

Есть случай, когда исполнитель написал плейбук, а заказчик сказал, не знаю, что это, распишите подробно, что нужно сделать.

Так что буду рад примерам, чтобы за что-то зацепиться.

Андрей, спасибо. Буду рад.

Пользователи VS Code, а какие плагины вы применяете для работы с RST? Подсветочка там, outline структуры документа ...

А есть ли сервисы где можно оставлять комментарии к срендерным md/rst/whatever документам?

Типа как гуглдок с комментариями но чтобы исходник хранился в гите в текстовой разметке

GitLab/GitHub

Разве там можно оставлять комменты к коду? (не к мердж реквестам)

Нет

Их уже пробовали, не подходит.

Мне нужны комменты к уже опубликованным материалам, а не к pr/mr

Плюс надо не пугать людей страшным программистским жаргоном

Я правильно понимаю, что вы хотите вести документы в MD/RST/…, но комментарии оставлять в отрендеренном виде? То есть, при изменении исходных документов комментарии, оставленные в рендере к прошлой версии, должны сохраняться?

Да, типа со снапшотом прошлой версии той части/абзаца/диффа где они были оставлены и пометкой что они устарели

Самое ближайшее что помню из этого это комменты в стэше к PR, но это не подходит

Не знаю, насколько это для вас будет оверкилл, но Foliant умеет выгружать из md-исходников в Confluence с более или менее сохранением инлайн-комментариев. Если место, которое было закомментировано, изменилось в новой версии документа, коммент сохранится (но как правило растянется на весь абзац, потому что точное место уже не определить).

звучит как оверкилл 🤔

но коммент получается тоже в тексте должен быть?

я, возможно, плохо это сформулировал выше, но я мечтаю о том что люди, которые могут вносить комментарии могут это делать в комментах к отренеренному тексту из чего-то вебообразного, им не надо выкачивать себе куда-то исходник

я надеюсь что я просто не знаю что есть такой SaaS который это умеет))

Нет, коммент оставляют в самой конфле, там принцип такой же, как в гуглдоке: выделяем текст и появляется окошко, где можно оставить комментарий к этому фрагменту