Book corrections

[gsvcrypto]

Предлагаю следующие правки:
1.1. Approach to learn programming - > Approach to learning programming.
2...C syntax - > C programming languages.
2.7. wrappers, and events - > wrappers and events (лишняя запятая).
4.3..., and generators - > and generators (также лишняя запятая).
6.1. Common for all paradigms - > Common antipatterns for all paradigms.
8.1. EventEmitter - > Event Emitters.
10.5. programming - > programming (пропущена буква r).

[tshemsedinov]

Спасибо!

• Часть правок тут: Fix spelling #17
• По поводу запятых - это серийная или оксфордская запятая же - https://en.wikipedia.org/wiki/Serial_comma
• EventEmitter - это общепринятое имя класса

[vpoliatychko]

Предлагаю правку: раздел 1.7, абзац 3, строчка: Внешние действия - это обращения к внешним устройствам ввода-вывода (сеть, диски, другие устройства), и они требуют ожидания реакции от устройства, которая придет время, обычно неизвестное заранее.
Я так понял, что в конце говорится о том, что реакция придет, но не известно за какое время.
Мой вариант: Внешние действия - это обращения к внешним устройствам ввода-вывода (сеть, диски, другие устройства), и они требуют ожидания реакции от устройства, которая придет за время, которое обычно неизвестное заранее.

[tshemsedinov]

Спасибо! Исправил в 9864ab7

[vpoliatychko]

Есть у меня небольшая идея по переделыванию абзаца 1, в разделе 1.2 об примерах, а конкретней:

Оригинал

Мы возьмем `JavaScript`, как самый распространенный, `Python`, потому, что есть области, где без него нельзя, а на первый взгляд он очень отличается от других C-подобных языков, хотя это только на первый взгляд, мы покажем, что он очень похож на `JavaScript` и сам `C`, как язык достаточно близкий к ассемблеру, все еще очень актуальный и оказавший самое большое влияние на современные языки и по синтаксису и по заложенным в него идеям.

Предлагаю переделать часть с перечеслениям языков для болия легкого, последовательного и логического прочтения, что-то в таком ключе:

Моё виденье

Мы возьмем `C`, как язык достаточно близкий к ассемблеру, все еще очень актуальный и оказавший самое большое влияние на современные языки и по синтаксису и по заложенным в него идеям, `JavaScript`, как самый распространенный язык имеющий `C`-подобный синтаксис,`Python`, потому, что есть области, где без него нельзя обойтись, а так-же потому-что на первый взгляд он очень отличается от других C-подобных языков, хотя это только на первый взгляд, мы покажем, что он очень похож на `JavaScript` и `C`.

[tshemsedinov]

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

[tshemsedinov]

Я все же переписал этот блок иначе. https://github.com/HowProgrammingWorks/Book/pull/88/files В пул-реквесте сравнивать варианты гораздо легче. Хоть оно и не очень адаптировано для текста. А вообще нам нужно ввести маркеры в главах:

• наброски
• готово к вычитке автором, орфографических и синтаксических правок
• вычитано автором
• готово для вычитки редактором или перевода
• переведено и готово для вычитки редактором
• вычитано редактором