Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Часткове оновлення І секції #207

Open
wants to merge 17 commits into
base: master
Choose a base branch
from

Conversation

burlakvo
Copy link
Contributor

@burlakvo burlakvo commented Oct 22, 2024

Оновлено

  • book/01-introduction/sections/about-version-control.asc
  • book/01-introduction/sections/command-line.asc
  • book/01-introduction/sections/first-time-setup.asc

Також додав примітку до плану і додав команду для видалення тимчасових файлів.

@hedrok
Copy link
Member

hedrok commented Oct 23, 2024

Я обовʼязково подивлюся, але ймовірно вже в пʼятницю. Можеш робити подальші зміни, але, будь ласка, окремими PR (можна до цієї гілки, просто щоб я точно зміг проревʼювати й залити цей).

Щодо вилучення файлів: я планував це залишити наостанок, імовірно є ж інклуд їх кудись?.. Десь текст про них в інших файлах?..
Тобто я думав, що коли вже все подібне почистимо, тоді й файли вилучати. Бо, наприклад, простий пошук з Eclipse дає (серед інших результатів):

A-git-in-other-environments.asc|14 col 52-59| include::book/A-git-in-other-environments/sections/eclipse.asc[]
book/introduction.asc|26 col 565-572| У *Додатку А* ми розглянемо приклади використання Git в кількох специфічних середовищах. Ми охоплюємо ряд графічних інтерфейсів та розробницьких середовищ, які, можливо, є у вас в наявності та якими ви можете захотіти користуватися. Якщо вас цікавить огляд користування Git у вашій оболонці розробки, Visual Studio чи Eclipse, -- загляньте сюди.

@burlakvo
Copy link
Contributor Author

Вилучення вивернув

Спокусився на легкість злиття, після зливання конфліктних файлів )

@burlakvo burlakvo changed the title Часткове оновлення І секції та вилучення файлів Часткове оновлення І секції Oct 28, 2024
Copy link
Member

@hedrok hedrok left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Усі коментарі невеличкі й радше до того, як воно було перекладено раніше.
Я не дивився різницю англійських версій (збирався, але й так пізніше ніж хотів би ревʼюваю, тож вирішив хоч так ревʼювати).
Тож тут повністю покладаюся на тебе )

image::images/local.png[Local version control diagram]

Одним з найбільш поширених інструментів СКВ була система під назвою RCS, яка досі поширюється з багатьма комп'ютерами сьогодні.
RCS зберігає набори латок (тобто, відмінності між файлами) в спеціальному форматі на диску; він може заново відтворити будь-який файл, як він виглядав, в будь-який момент часу, шляхом додавання всіх латок.
https://www.gnu.org/software/rcs/[RCS^] зберігає набори латок (тобто, відмінності між файлами) в спеціальному форматі на диску; він може заново відтворити будь-який файл, як він виглядав, в будь-який момент часу, шляхом додавання всіх латок.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Пропоную
"заново відтворити будь-який файл, як він виглядав, в будь-який момент часу" -> "відновити стан файлу на будь-який час"
(бачу, що ти не змінював, але як на мене, неоковирно)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Я, звісно, тут новенький і можу мало знати про місцеві правила, але як на мене — "як він виглядав, в будь-який момент часу" виглядає найбільш природньо і просто для розуміння.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Переписав як "вона може заново відтворити стан будь-якого файлу у будь-який момент часу" ))

book/01-introduction/sections/first-time-setup.asc Outdated Show resolved Hide resolved
@dev99problems
Copy link
Contributor

Вітаю @burlakvo , @hedrok 👋
Хотів запитати чи є плани і можливість вмерджити цю частину?
Хотілось би поверх неї ще надіслати деякі "покращення" до 1-го розділу

@burlakvo
Copy link
Contributor Author

burlakvo commented Nov 14, 2024

Хотів запитати чи є плани і можливість вмерджити цю частину?

@dev99problems, привіт 👋
Я ще працюю над цим)
Сподіваюсь, матиму час найближчими днями завершити

UPD: я надіслав зміни, які вже встиг зробити, але там конфлікти вилізли, тож не вийшло хоч трохи розблокувати роботу

@dev99problems
Copy link
Contributor

Хотів запитати чи є плани і можливість вмерджити цю частину?

@dev99problems, привіт 👋 Я ще працюю над цим) Сподіваюсь, матиму час найближчими днями завершити

UPD: я надіслав зміни, які вже встиг зробити, але там конфлікти вилізли, тож не вийшло хоч трохи розблокувати роботу

Привіт @burlakvo 👋
Взагалі не проблема, я поки подивлюсь чим я можу бути корисним в цьому проєкті.

@burlakvo
Copy link
Contributor Author

@hedrok, пройшовся по перекладам, узгодженим термінам. Треба ще завершити із C-git-commands, можливо, поки просто додам відсутню секцію на яку посилається about-version-control.asc

сс @dev99problems

Copy link
Member

@hedrok hedrok left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Два дрібненькі коментарі, сподіваюся ти швидко виправиш і заллємо )


Якщо ви графічний або веб-дизайнер і хочете зберегти кожну версію зображення або макета (швидше за все, захочете), система контролю версій (далі СКВ) якраз те, що потрібно.
Вона дозволяє повернути вибрані файли до попереднього стану, повернути весь проект до попереднього стану, побачити зміни, побачити, хто останній міняв щось і спровокував проблему, хто вказав на проблему і коли, та багато іншого.
Вона дозволяє вивернути вибрані файли до попереднього стану, вивернути весь проєкт до попереднього стану, побачити зміни, побачити, хто останній міняв щось і спровокував проблему, хто вказав на проблему і коли, та багато іншого.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Тут використано revert як звичайне англійське слово, тож переклад "повернути" доречний.
Це можна робити командами checkout, reset тощо. Насправді командою revert це робиться вкрай зрідка.

Крім того дуже рекомендую при першому використанні наших новотворів в дужках подавати оригінал. Можливо, навіть раз на розділ чи навіть секцію, бо певен, люди часто читатимуть те, що їх цікавить, а не всю книжку від дошки до дошки.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Захопився ))

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

А, о, згадав про перше використання

`C:\Documents and Settings\All Users\Application Data\Git\config` під Windows XP, і `C:\ProgramData\Git\config` під Windows Vista й новіші.
У системах Windows, Git шукає файл `.gitconfig` у теці `$HOME` (`C:\Users\$USER` для більшості користувачів).
Також, він все одно шукає файл `[path]/etc/gitconfig`, хоча й відносно кореня MSys, котрий знаходиться там, де ви вирішили встановити Git у вашій Windows системі, коли ви запускали інсталяцію.
Якщо ви використовуєте Git для Windows версії 2.x або новішу, то є також системний конфігураційний файл `C:\Documents and Settings\All Users\Application Data\Git\config` під Windows XP, і `C:\ProgramData\Git\config` під Windows Vista й новіші.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

новіші -> новішими?..

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Я б додав декілька ком після config' перед під

Щодо "новішими"... не певен.
"під [операційну систему] Windows Vista й новіші [операційні системи]"
"у [операційній системі] Windows Vista й новіших [операційних систем]"
А от до "новішими" не можу підібрати формулювання

Copy link
Contributor

@dev99problems dev99problems Nov 25, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Якщо ви використовуєте Git для Windows версії 2.x або новішу, то є також системний конфігураційний файл C:\Documents and Settings\All Users\Application Data\Git\config під Windows XP, і C:\ProgramData\Git\config під Windows Vista й новіші.
Це прям якось важкувато читається.

Можливо щось з наступного стане у нагоді:
Якщо ви використовуєте Git для Windows версії 2.x і новіших, також існує системний конфігураційний файл C:\Documents and Settings\All Users\Application Data\Git\config під Windows XP, а починаючи з Windows Vista C:\ProgramData\Git\config .

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dev99problems, дякую, стало ))

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Щодо "анотований tag" та "легкий tag": якщо ми вже маємо узгоджений переклад для "tag - мітка", то може використати його і тут? Тобто "анотована мітка" та "легка мітка"

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Я коли проглядав словник проєкту, то деякі терміни взагалі складно сприймати/прийняти.
До прикладу, для мене мітка — це "label", а tag — це тег і так як це проєкт технічної документації, то мене трохи дивує, коли я знаючи контекст і термінологію в оригіналі, читаю український переклад і не можу зрозуміти сенс цілих речень.


Якщо ви графічний або веб-дизайнер і хочете зберегти кожну версію зображення або макета (швидше за все, захочете), система контролю версій (далі СКВ) якраз те, що потрібно.
Вона дозволяє повернути вибрані файли до попереднього стану, повернути весь проект до попереднього стану, побачити зміни, побачити, хто останній міняв щось і спровокував проблему, хто вказав на проблему і коли, та багато іншого.
Вона дозволяє повернути вибрані файли до попереднього стану, повернути весь проєкт до попереднього стану, побачити зміни, побачити, хто останній міняв щось і спровокував проблему, хто вказав на проблему і коли, та багато іншого.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Може "хто останній міняв щось" -> "хто останній вносив зміни"?

Copy link
Contributor

@dev99problems dev99problems left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@burlakvo чудова робота 👏
Залишив декілька невеликих коментарів, але по багатьом взагалі не наполягаю

Даний підхід є дуже поширеним завдяки його простоті, проте він, неймовірним чином, схильний до появи помилок.
Можна легко забути в якій директорії ви знаходитеся і випадково змінити не той файл або скопіювати не ті файли, які ви хотіли.
Можна легко забути в якій теці ви знаходитеся і випадково змінити не той файл або скопіювати не ті файли, які ви хотіли.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Може "знаходитесь"?

Кожна копія дійсно є повною резервною копією всіх даних.
Ось тут до гри долучаються розподілені системи контролю версій (РСКВ).
В РСКВ (таких як, Git, Mercurial або Darcs), клієнти не просто отримують останній відбиток файлів репозиторія: натомість вони є повною копією сховища разом з усією його історією.
Таким чином, якщо вмирає який-небудь сервер, через який співпрацюють розробники, будь-яке з клієнтських сховищ може бути скопійований назад до серверу, щоб відновити його.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

А як щодо "Таким чином, якщо з ладу виходить центральний сервер, через...".

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"будь-яке з клієнтських сховищ може бути скопійоваНЕ"

Ось тут до гри долучаються розподілені системи контролю версій (РСКВ).
В РСКВ (таких як, Git, Mercurial або Darcs), клієнти не просто отримують останній відбиток файлів репозиторія: натомість вони є повною копією сховища разом з усією його історією.
Таким чином, якщо вмирає який-небудь сервер, через який співпрацюють розробники, будь-яке з клієнтських сховищ може бути скопійований назад до серверу, щоб відновити його.
Кожна копія являє собою повну резервну копію всіх даних.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Мені подобається "являє собою", але переживаю що це може бути калька з ру.
Можливо краще "Кожна копія є повною резервною копією усіх даних."?

Це потрібно виконати лише один раз - налаштування залишаються між оновленнями.
Ви також можете змінити їх у будь-який час, знову виконавши декілька команд.

До Git входить утиліта що має назву `git config`, яка дозволяє отримати чи встановити параметри, що контролюють усіма аспектами того, як Git виглядає чи працює.
До Git входить утиліта що має назву `git config`, яка дозволяє отримати чи встановити параметри, що контролюють усіма аспектами того, як Git виглядає чи працює.(((git commands, config)))
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Може "яка дозволяє отримати чи встановити" -> "яка дозволяє відобразити чи встановити" або "яка дозволяє переглянути чи налаштувати | задати параметри"

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"що контролюють усі аспекТИ того"

Якщо ви передаєте опцію `--system` при виконанні `git config`, параметри читаються та пишуться з цього файлу.
(Це системний файл конфігурації, відповідно, вам потрібен був доступ адміністратора чи суперкористувача, щоб змінювати його.)
Оскільки це системний файл конфігурації, відповідно, вам знадобяться права адміністратора чи суперкористувача, щоб змінювати його.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"вам знадобяться" -> "вам необхідні | вам потрібні | вам знадобЛяться"?

2. Файл `~/.gitconfig` або `~/.config/git/config` зберігає значення саме для вас -- користувача.
Ви можете налаштувати Git читати і писати в цей файл, вказуючи опцію `--global.`
3. Файл `config` у каталозі Git (тобто `.git/config`) у тому репозиторії, який ви використовуєте в даний момент, зберігає налаштування конкретного репозиторія.
Ви можете спрямувати Git читати і писати в цей файл, передавши опцію `--global`, що вплине на _всі_ сховища з якими ви працюєте у вашій системі.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Як на мене, "спрямувати" звучить трохи дивно в цьому контексті, як б радше використовував його з "спрямувати стрім" але в цьому місці ніби проситься саме "налаштувати"

Перше, що ви повинні зробити, коли ви інсталюєте Git - це встановити ім'я користувача та адресу електронної пошти.
Це важливо, тому що кожен коміт в Git використовує цю інформацію, і вона незмінно включена у комміти, які ви робите:
Перше, що ви повинні зробити, коли ви інсталюєте Git -- це встановити ім'я користувача та адресу електронної пошти.
Це важливо, тому що кожен коміт в Git використовує цю інформацію, і вона незмінно включена у коміти, які ви робите:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

А тут потрібна кома перед "і", в "і вона незмінно"

Під Windows, якщо ви бажаєте використати інший текстовий редактор, то маєте вказати повний шлях до відповідної програми.
Це залежить від того, як ваш редактор поставляється.
Під Windows, якщо ви бажаєте використати інший текстовий редактор, то маєте вказати повний шлях до його виконуваного файлу.
Він може різнитися залежно від того, як ваш редактор поставляється.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Тут "як ваш редактор поставляється" — звучить дуже дивно, хоча я і розумію що малось на увазі.
Може є якісь ідеї?

----

[NOTE]
====
Vim, Emacs і Notepad++ -- це популярні текстові редактори, що їх часто використовують розробники на Unix-похідних системах (на кшталт Linux та macOS) та на Windows.
Якщо ви не знайомі з цими редакторами, можливо, вам потрібно буде знайти інструкції з налаштуванню вашого улюбленого редактора з Git.
Якщо ви використовуєте інші редактори або 32-бітові версії, ласкаво просимо знайти інструкції з налаштуванню вашого улюбленого редактора з Git у <<C-git-commands#ch_core_editor>>.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Якщо вже залишати "ласкаво просимо", то можливо хоча б "ласкаво просимо переглянути інструкції з..."?

@hedrok
Copy link
Member

hedrok commented Nov 29, 2024

@burlakvo будь ласка, прокоментуй, чи варто вже заливати, чи ти щось будеш відповідати/змінювати згідно з коментарями @dev99problems.
Можемо залити зараз, а обробиш коментарі окремим PR, не надто зручно, але принаймні заллємо нарешті )

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants