Size: a a a

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

2021 October 22

NV

Nick Volynkin in DocOps-сообщество
так-то в автомобиле тоже две-три педали, руль да пара рычагов, можно за две минуты рассказать
источник

NV

Nick Volynkin in DocOps-сообщество
но навык вождения за две минуты не получается приобрести )
источник

L

Lana in DocOps-сообщество
Тут выбор каждого смотреть-не смотреть, я отвечала на конкретный запрос коллеги. Для меня в этом митапе ценно именно объяснение принципов, потому что можно механически повторять команды, а можно понимать, что именно ты делаешь и что происходит под капотом + возможный результат твоих действий локально и удаленно, но при этом не хардкорно. Но раз так раздражает прям - ссылку убрала
источник

RG

Ramil G in DocOps-сообщество
я не говорил, что раздражает. Вообще, я высказался так как считаю расточительным смотреть часовой ролик. Вот предыдущая ссылка с практикой мне понравилась, я даже немного поразбирался с rebase
источник

NV

Nick Volynkin in DocOps-сообщество
иногда ролики очень полезны бывают https://t.me/docops/323
источник

RG

Ramil G in DocOps-сообщество
спасибо. гляну
источник

D

Denis in DocOps-сообщество
Спасибо!
источник

D

Denis in DocOps-сообщество
Насчёт объяснения, зачем это, не уверен, что хочу этим заниматься. Мне нужно перевести процессы с ворда на docs-as-code. Для этого надо обучить разметке и гиту. От разметки никуда не денешься, но в сочетании с гитом прям тяжело идёт. Слишком много нового сразу.
источник

L

Lex in DocOps-сообщество
Разметке обучить несложно. Особенно если старый контент сконвертирован в маркдаун.

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

NV

Nick Volynkin in DocOps-сообщество
👍
источник

BF

Bobba Fett in DocOps-сообщество
Научить пользоваться гитом очень просто, но работает 50/50: выдаёшь комп с убунту сервером (без десктопного окружения). Через неделю человек либо уже умеет писать доки в виме, пользоваться гитом и скриптить процессы сборки и тестирования документации, либо он бесполезен.
источник

VB

Vitaly Belyakov in DocOps-сообщество
это такой пятничный юмор?)
источник

RG

Ramil G in DocOps-сообщество
Я думал, что будет: либо там стоит винда и ворд
источник

BF

Bobba Fett in DocOps-сообщество
есть ещё третий вариант: либо надо было сразу объяснить, как из вима выйти
источник

D

Denis in DocOps-сообщество
Это лютая жесть, конечно))
источник

D

Denis in DocOps-сообщество
У меня есть положительный опыт со скриптом для билда в sphinx. В скрипте есть две опции: build docx и build html. И все это в цикле, билдить можно хоть каждую минуту. Полезно для изучения разметки. Минус в том, что обучившийся в итоге не представляет, как работает sphinx под капотом. Вот думаю что-то подобное для гита сделать.
источник

iv

iakov v in DocOps-сообщество
Гит страшен тем, что под капотом у верхнеуровневых (porcelain) команд у него есть ещё и нижнеуровневые (plumbing), и когда в мануале обо всём этом читаешь, остатки волос на голове шевелиться начинают
источник

D

Denis in DocOps-сообщество
Да, нужно как-то ограничить информацию, а то хочется сразу бежать.
источник

L

Lex in DocOps-сообщество
поэтому подробная инструкция рулит.
можно начинать привыкать к  верхнеуровневым повседневным вещам, а под капот лезть уже когда прижмёт
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
На гитхабе можно основные операции в вебинтерфейсе делать
источник