Size: a a a

Технические писатели

2021 August 06

NV

Nick Volynkin in Технические писатели
> адекватно работать с документацией в гитхабе

Клонируете репозиторий себе на рабочую машину (git clone ...), потом редактируете, сохраняете в отдельную ветку, отправляете на гитхаб, открываете пулл-реквест. В нём проходит ревью. Когда исправляете замечания, добавляете их новыми коммитами в ту же ветку. Когда задача готова, мержите пулл-реквест, и ваши изменения попадают в основную ветку (master или main).

> При этом не хочется весь репозиторий копировать себе

Это в общем-то легко и быстро делается, почему бы не скопировать?
источник

H

Hartmann in Технические писатели
Значит в ГитХабе и редактируйте.
Как вариант, можете попробовать GitHub Pages, если так проще будет и они там действительно нужны.
источник

A

Andrew in Технические писатели
Может там репо на терабайт :)
источник

NV

Nick Volynkin in Технические писатели
50 сервисов на терабайт кода? Ну да, может и так )
источник

К

Катя Морозова... in Технические писатели
Я исхожу из того, что может быть есть решение, о котором я не знаю, и которое позволяет не клонировать себе то, что не нужно
источник

ET

Eduard Tibet in Технические писатели
Но ведь если что-то надо изменить - это же нужно :)
источник

К

Катя Морозова... in Технические писатели
Но менять нужно только мдшки
источник

К

Катя Морозова... in Технические писатели
Ок, если такого кейса не было, сори)
источник

NV

Nick Volynkin in Технические писатели
Кейс не то что был, а каждый день так работаем. Клонируйте репозиторий, это нормальный способ работы. У вас есть какие-то непреодолимые препятствия, чтобы это сделать, вроде репозитория на терабайт?
источник

NV

Nick Volynkin in Технические писатели
В принцпе, вы можете прямо на гитхабе редактировать документы, но это будет менее производительно, чем на рабочей машине. Опечатку исправить — да, написать статью — нет.
источник

К

Катя Морозова... in Технические писатели
непреодолимых препятствий нет, хотелось узнать, возможно ли в принципе без этого, то есть клонировать только файлы md, например

а какой тулзой пользуетесь для работы с файлами локально?
источник

FM

Fox Mulder in Технические писатели
VS Code or Idea JB
источник

К

Катя Морозова... in Технические писатели
жесть, спасибо)
источник

AG

Anna Gasparyan in Технические писатели
А в чем жесть? В идее удобная работа с гит репозиторием из коробки, для VSCode есть плагины с похожей функциональностью. Все не страшно
источник

К

Катя Морозова... in Технические писатели
Я попробую 🤞спасибо
источник

BF

Bobba Fett in Технические писатели
Технически это возможно. Нужно клонировать репо без чекаута файлов и потом сделать чекаут только нужных файлов. Но работать с таким состоянием репо будет довольно сложно, тем более если вы в принципе не имеете опыта работы с гит репо, потому что все остальные файлы с точки зрения вашего локального клона будут считаться удаленными и нужно будет постоянно помнить об этом, чтобы случайно не запушить это самое удаление
источник

К

Катя Морозова... in Технические писатели
И чекаут файлов нужно будет делать вручную, не получится сказать «выбери только *.md»?
источник

FM

Fox Mulder in Технические писатели
Петин кот перед дождём всегда чихает. Сегодня кот чихнул. «Значит, скоро будет дождь», – подумал Петя. Прав ли Петя?
источник

FM

Fox Mulder in Технические писатели
Почему не получится? Всё получится и можно.
источник

FM

Fox Mulder in Технические писатели
по памяти (могу немного ошибиться)
git checkout — *.md
источник