может как раз в этом проблема? нужно по одной новой вещи за раз вносить? Иначе когда много нового и что-то ломается непонятно куда копать

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

можно подробнее?

ну вот если вы откроете man git, то увидите, насколько там много всяких кишок и кишочков, и мне до сих пор не попадалось хорошего введения в git, которое не создавало бы кашу в голове. предметная область довольно большая, use cases очень много, поэтому структурировать информацию сложно, особенно если вообще с контролем версий до сих пор не сталкивался. А более-менее внятные учебники уже нельзя назвать "коротким введением", потому что они получаются объёмные.

Я профессионально пользуюсь гитом лет 8, использую несколько команд типа коммит, пуш, пул, ребейз, мердж. Причем часть команд использую из консоли с вимом (rebase --onto, rebase -i, reflog, когда несколько команд надо цепочкой запустить), часть из IDEA (3-х сторонний мердж великолепен, бранчи, простые коммиты и пуши норм, а дерево отвратительно сделано, недавно добавили частичные мерджи – тоже удобно и пользуюсь), часть из SourceTree (все что связано с просмотром дерева, простыми ребейзами или частичными коммитами). Почему-то нет одного инструмента в котором все сделано удобно. В кишки приходилось лезть в ооооочень редких случаях когда все напрочь поломалось и хочется починить без тупого клонирования репозитория с нуля потому что он весит несколько гигов.

Предметная область в кишках очень простая на самом деле, буквально объекты и ссылки на них, все остальное накручено поверх. При этом можно зайти в папку .git и в обычном текстовом редакторе все увидеть. В этом настольно нет никакой магии что даже удивительно. Для понимания достаточно одной главы https://git-scm.com/book/ru/v2/Git-%D0%B8%D0%B7%D0%BD%D1%83%D1%82%D1%80%D0%B8-%D0%9E%D0%B1%D1%8A%D0%B5%D0%BA%D1%82%D1%8B-Git. Но при этом ни разу вообще не приходилось опускаться на этот уровень. Самое низкоуровневое, что приходилось делать – это восстанавливать удаленную ветку из рефлога.

вы это пишете после 8 лет в материале, и это вполне естественно. но вопрос был про "обучить техписателей работе в гит". может быть и есть толковое руководство, которое объяснит все ключевые понятия, необходимые для работы с пятью командами, и не вызовет взрыв мозга, но мне такое не попадалось. man git для этого прям отчётливо не подходит.

про man git есть даже прикол по генерации случайных справочных страниц https://git-man-page-generator.lokaltog.net/ не отличимо от настоящих

да-да, обожаю это :)

раньше у гитхаба был проект try.github.com там была последовательность из 20 уроков которые надо выполнить чтобы въехать. но потом проект почему-то закрыли

вот это рекомендуют https://ohmygit.org

сам не пробовал

вот это интересная https://learngitbranching.js.org

Это лучше моей документации…

сорри, что врываюсь поздно.

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

Поэтому рекомендую

1. Рассказать в общих чертах про коммты-ветки-пуши-пуллы-стейджи-сташи.
2. Дать им гит-клиенты “для маленьких”, где явно видны частые фукции, и не видны сложные. GitHub Desktop - имхо идеальный вариант.

@properevod77 ^

Спасибо, будем пробовать через vscode. Там в принципе двумя кнопками можно обойтись.

Мое имхо - лучше отдельный клиент. Чтоб текст - отдельно, управление историей - отдельно. Так нет перемешивания контекста.

Но вам видней.

консоль форева!

мощнее, чем любой клиент, и не искажает смысл происходящего