Size: a a a

DocOps-сообщество

2019 July 27

IA

Ivan Abashkin in DocOps-сообщество
Max
Можно запретить разрывать разделы, и иллюстрации с текстом ставить в один раздел
я видел в аскидокторе опцию keep together,  но она у меня не заработала при генерации.
источник

NV

Nick Volynkin in DocOps-сообщество
Александр Парень
Завтра мой доклад на ITGlobalMeetup
Про Конфлюенс доклад?
источник

АП

Александр Парень in DocOps-сообщество
Nick Volynkin
Про Конфлюенс доклад?
В целом про Атлассиан Клауд-инстансы
источник

NV

Nick Volynkin in DocOps-сообщество
Ivan Abashkin
а как правильно? У меня иллюстрации от текста отделялись, а нужно было, чтобы они на одной странице были
Что если ставить картинку не после параграфа, а инлайн в конец параграфа, а потом стилями в CSS её выставлять под параграф? Тогда она не должна будет отрываться от параграфа.
источник

NV

Nick Volynkin in DocOps-сообщество
Александр Парень
В целом про Атлассиан Клауд-инстансы
А подробнее?
источник

АП

Александр Парень in DocOps-сообщество
Ну вообще там доклады все без проекторов, так что, кто надеется увидеть какие-то фишки, то будет немного удивлён
источник

NK

ID:0 in DocOps-сообщество
​​Вот три примера кода:
источник

ДБ

Дмитрий Башкирцев in DocOps-сообщество
И что в итоге-то?
источник

ДБ

Дмитрий Башкирцев in DocOps-сообщество
Что надо после апострофов указывать синтаксис?
источник

NV

Nick Volynkin in DocOps-сообщество
Дмитрий Башкирцев
Что надо после апострофов указывать синтаксис?
Это про что вопрос?
источник

ДБ

Дмитрий Башкирцев in DocOps-сообщество
Nick Volynkin
Это про что вопрос?
Про голосовалку
источник

NV

Nick Volynkin in DocOps-сообщество
Есть документация, в которой важно донести до читателя, каких прав требует каждая команда. Сейчас для этого используются разные приветствия терминала. Я сомневаюсь, что читатели это понимают правильно. Тем более, что root ≠ sudoer, а в контейнерах вообще обычно root.
источник

ДБ

Дмитрий Башкирцев in DocOps-сообщество
От ЦА же зависит
источник

NV

Nick Volynkin in DocOps-сообщество
У меня свой субъективный опыт. Я привык, что все зависимости ставятся либо на пользователя или в виртуальное окружение — там рут вообще не нужен и вреден, либо при сборке докер-образа — там рут по умолчанию и sudo не нужно. А под рутом я вообще не сижу почти никогда, так что и приветствие рутовое не узнаю.
источник

NV

Nick Volynkin in DocOps-сообщество
Дмитрий Башкирцев
От ЦА же зависит
Да, конечно. ЦА — разработчики, админы, тестировщики, инфобезопасники. Не знаю точно, привыкли они различать в документации пользователей по приветствию терминала, или нет.
источник

ДБ

Дмитрий Башкирцев in DocOps-сообщество
Я бы в вводной части вписал, типа это читать так, а это сяк.
источник

ДБ

Дмитрий Башкирцев in DocOps-сообщество
Если на широкую аудиторию нацеливал писанину
источник

ДБ

Дмитрий Башкирцев in DocOps-сообщество
Или глоссарий
источник

NV

Nick Volynkin in DocOps-сообщество
Вот я по обзору вижу, что половина различает. Думаю, что для остальных хорошо бы это как-то дополнительно обозначить.
источник

ДБ

Дмитрий Башкирцев in DocOps-сообщество
Еще и от контекста зависит
источник