Skip to content

Опечатки, кавычки, проблемы с форматированием - #337

Merged
Morganov merged 17 commits into
progit:masterfrom
srgizh:master
Jan 21, 2021
Merged

Morganov merged 17 commits into
progit:masterfrom
srgizh:master

Conversation

@srgizh

@srgizh srgizh commented Jan 15, 2021

Copy link
Copy Markdown
Contributor

No description provided.

@srgizh
srgizh marked this pull request as ready for review January 15, 2021 06:42
@srgizh srgizh changed the title Исправлена опечатка и несколько кавычек Исправлена опечатка и кавычки заменены на русские Jan 15, 2021
Comment thread C-git-commands.asc Resolved
Comment thread C-git-commands.asc Resolved
Comment thread C-git-commands.asc Resolved
Comment thread README.asc Resolved
@Morganov

Morganov commented Jan 17, 2021 •

Copy link
Copy Markdown
Member

Хотелось бы добавить, что неплохо было бы иметь дополение в TRANSLATION_NOTES.asc, поясняющее в каких случаях использовать какие кавычки.
Также, беглый поиск по тексту показал, что не везде заменены кавычки.

@srgizh

srgizh commented Jan 17, 2021

Copy link
Copy Markdown
Contributor Author

@Morganov Ещё раз:
В текстах принято ставить кавычки ёлочки.
В коде — машинописные двойные или одинарные кавычки.

Можно увидеть место, где не заменил? Я проверил все файлы в два захода. В первом коммите asciidoc-кавычки убрал, а во втором подчистил машинописные.

@srgizh

srgizh commented Jan 17, 2021

Copy link
Copy Markdown
Contributor Author

@Morganov Поправил все замечания

==== Двухфакторная аутентификация

В качестве дополнительной меры безопасности, вы можете настроить "Двухфакторную аутентификацию" (``Two-factor Authentication'' или ``2FA'').
В качестве дополнительной меры безопасности, вы можете настроить "Двухфакторную аутентификацию" («Two-factor Authentication» или «2FA»).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Смотрю общий diff - не вижу "второго прохода".

Comment thread book/B-embedding-git/sections/jgit.asc Resolved
@Morganov

Copy link
Copy Markdown
Member

Можно увидеть место, где не заменил? Я проверил все файлы в два захода. В первом коммите asciidoc-кавычки убрал, а во втором подчистил машинописные.

Да, вот список файлов с номерами строк, где остались "лапки"

./book/A-git-in-other-environments/sections/guis.asc:85
./book/A-git-in-other-environments/sections/guis.asc:113
./book/A-git-in-other-environments/sections/guis.asc:139
./book/A-git-in-other-environments/sections/zsh.asc:49
./book/02-git-basics/sections/viewing-history.asc:221
./book/02-git-basics/sections/viewing-history.asc:242
./book/08-customizing-git/sections/config.asc:392
./book/09-git-and-other-scms/sections/client-bzr.asc:89
./book/09-git-and-other-scms/sections/client-bzr.asc:90
./book/09-git-and-other-scms/sections/client-bzr.asc:98
./book/09-git-and-other-scms/sections/import-bzr.asc:133
./book/09-git-and-other-scms/sections/client-hg.asc:10
./book/09-git-and-other-scms/sections/client-hg.asc:41
./book/09-git-and-other-scms/sections/client-hg.asc:97
./book/09-git-and-other-scms/sections/client-hg.asc:125
./book/09-git-and-other-scms/sections/client-hg.asc:237
./book/09-git-and-other-scms/sections/client-svn.asc:7
./book/09-git-and-other-scms/sections/client-svn.asc:113
./book/09-git-and-other-scms/sections/client-svn.asc:374
./book/09-git-and-other-scms/sections/client-svn.asc:481
./book/09-git-and-other-scms/sections/client-p4.asc:166
./book/09-git-and-other-scms/sections/client-p4.asc:370
./book/09-git-and-other-scms/sections/client-p4.asc:646
./book/06-github/sections/3-maintaining.asc:180
./book/06-github/sections/3-maintaining.asc:190
./book/06-github/sections/1-setting-up-account.asc:47
./book/06-github/sections/1-setting-up-account.asc:66
./book/06-github/sections/2-contributing.asc:131
./book/07-git-tools/sections/credentials.asc:11
./book/07-git-tools/sections/rerere.asc:145
./book/07-git-tools/sections/replace.asc:6
./book/07-git-tools/sections/replace.asc:153

@srgizh

srgizh commented Jan 17, 2021

Copy link
Copy Markdown
Contributor Author

„лапки“ — вот это лапки. Таких не искал и сейчас вроде нет.
“английские двойные” тоже не искал. Сейчас вижу ещё одно место с ними.
Кавычки в виде кодов пропускал в файлах с неполным переводом

@Morganov

Copy link
Copy Markdown
Member

Исправьте образовавшиеся конфлифкты и замечания к текущим изменениям. Думаю, этого будет достаточно на текущий момент.
Не стоит на долго откладывать внесение предложенных изменений.

Co-authored-by: Dexter <Dexter.morganov@gmail.com>

Убрано неуместное повелительное наклонение «загляни́те»
Наверное хотели написать «загля́нете». Но перефразировал предложение немного иначе.
@srgizh
srgizh force-pushed the master branch 5 times, most recently from 7204436 to 096bada Compare January 18, 2021 20:15
Comment thread .gitignore Resolved
Comment thread .gitignore Resolved
Comment thread .mailmap Resolved
Comment thread locale/attributes-ru.adoc Resolved
srgizh and others added 3 commits January 18, 2021 14:31
Table of Context → Содержание
Figure → Рисунок
и др.
It is unnecessary to track Gemfile.lock because it is platform dependant and it causes problems to build the book.
@srgizh

srgizh commented Jan 18, 2021

Copy link
Copy Markdown
Contributor Author

Пора уже смержить мои правки. Почти все замечания это не мои ошибки, а предложение новых доработок.
Работы тут ещё много, но приходится разрешать новые конфликты вместо реальных проблем.

Co-authored-by: Dexter <Dexter.morganov@gmail.com>
@srgizh srgizh changed the title Исправлена опечатка и кавычки заменены на русские Опечатки, кавычки, проблемы с форматированием Jan 19, 2021
Comment thread locale/attributes-ru.adoc Resolved
@Morganov

Copy link
Copy Markdown
Member

Пора уже смержить мои правки. Почти все замечания это не мои ошибки, а предложение новых доработок.
Работы тут ещё много, но приходится разрешать новые конфликты вместо реальных проблем.

Правки мержатся по мере их готовности и полноты, а не по времени, в течение которого вы не можете привести их в порядок.
Если вы вносите изменение в предложение, будте добры прочитать его и, по возможности, исправить имеющиеся ошибки.

Чтобы избежать длительного ревью:

  • Воздержитесь от объёмных правок. Если это не представляется возможным, разделите изменения соответственно разделам или главам книги. Можно создать несколько ПР с правками к разным главам и дорабатывать их независимо.
  • Не включайте разнотипные изменения в один ПР. Часто слияние задерживается только из-за того, что есть замечания к одного типа изменениям. В вашем случае это добавление неиспользуемого файла.
  • Используйте дополнительную функциональность GitHub (некоторые взможности приведены в книге), чтобы сделать процесс вашей работы над изменениями большого объёма более прозрачным.

Всё это может значительно ускорить процесс ревью. Цените чужое время.

@Morganov
Morganov merged commit a3f2d61 into progit:master Jan 21, 2021
@srgizh

srgizh commented Jan 21, 2021

Copy link
Copy Markdown
Contributor Author

Спасибо за замечания. Я сам не ожидал, что все правки свалятся в один ПР. Видимо потому, что не создал отдельную ветку для каждого изменения.

Насчёт неиспользуемого файла не понял. Он как раз очень нужен и использовался для локализации.

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