Вычитка

[iliakan]

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

Даже после хорошего перевода бывают предложения, написанные не совсем по-русски, непонятные объяснения и т.п.

Чтобы это отловить, достаточно прочитать русский текст свежим взглядом.

Можно сделать это локально, установив сервер https://github.com/javascript-tutorial/server.

Если что не так - PR. Я сам помечу статью галочкой после вычитки.

Спасибо!

The JavaScript language

An introduction

• An Introduction to JavaScript
• Manuals and specifications
• Code editors
• Developer console

JavaScript Fundamentals

• Hello, world!
• Code structure
• The modern mode, "use strict"
• Variables
• Data types
• Type Conversions
• Operators
• Comparisons
• Interaction: alert, prompt, confirm
• Conditional operators: if, '?'
• Logical operators
• Loops: while and for
• The "switch" statement
• Functions
• Function expressions and arrows
• JavaScript specials

Code quality

• Debugging in Chrome
• Coding Style
• Comments
• Ninja code
• Automated testing with mocha
• Polyfills

Objects: the basics

• Objects
• Garbage collection
• Symbol type
• Object methods, "this"
• Object to primitive conversion
• Constructor, operator "new"

Data types

• Methods of primitives
• Numbers
• Strings
• Arrays
• Array methods
• Iterables
• Map and Set
• WeakMap and WeakSet
• Object.keys, values, entries
• Destructuring assignment
• Date and time
• JSON methods, toJSON

Advanced working with functions

• Recursion and stack
• Rest parameters and spread operator
• Closure
• The old "var"
• Global object
• Function object, NFE
• The "new Function" syntax
• Scheduling: setTimeout and setInterval
• Decorators and forwarding, call/apply
• Function binding
• Arrow functions revisited

Object properties configuration

• Property flags and descriptors
• Property getters and setters

Prototypes, inheritance

• Prototypal inheritance
• F.prototype
• Native prototypes
• Prototype methods, objects without proto

Classes

• Class basic syntax
• Class inheritance
• Static properties and methods
• Private and protected properties and methods
• Extending built-in classes
• Class checking: "instanceof"
• Mixins

Error handling

• Error handling, "try..catch"
• Custom errors, extending Error

Promises, async/await

• Introduction: callbacks
• Promise
• Promises chaining
• Error handling with promises
• Promise API
• Promisification
• Microtasks
• Async/await

Generators, advanced iteration

• Generators
• Async iterators and generators

Modules

• Modules, introduction
• Export and Import
• Dynamic imports

Miscellaneous

• Proxy and Reflect
• Eval: run a code string

Browser: Document, Events, Interfaces

Document

• Browser environment, specs
• DOM tree
• Walking the DOM
• Searching: getElement*, querySelector*
• Node properties: type, tag and contents
• Attributes and properties
• Modifying the document
• Styles and classes
• Element size and scrolling
• Window sizes and scrolling
• Coordinates

Introduction to Events

• Introduction to browser events
• Bubbling and capturing
• Event delegation
• Browser default actions
• Dispatching custom events

UI Events

• Mouse events basics
• Moving: mouseover/out, mouseenter/leave
• Drag'n'Drop with mouse events
• Keyboard: keydown and keyup
• Scrolling

Forms, controls

• Form properties and methods
• Focusing: focus/blur
• Events: change, input, cut, copy, paste
• Forms: event and method submit

Document and resource loading

• Page: DOMContentLoaded, load, beforeunload, unload
• Scripts: async, defer
• Resource loading: onload and onerror

Miscellaneous

• Mutation observer
• Selection and Range
• Event loop: microtasks and macrotasks

Frames and windows

• Popups and window methods
• Cross-window communication
• The clickjacking attack

Binary data, files

• ArrayBuffer, binary arrays
• TextDecoder and TextEncoder
• Blob
• File and FileReader

Network requests

• Fetch
• FormData
• Fetch: Download progress
• Fetch: Abort
• Fetch: Cross-Origin Requests
• Fetch API
• URL objects
• XMLHttpRequest
• Resumable file upload
• Long polling
• WebSocket
• Server Sent Events

Storing data in the browser

• Cookies, document.cookie
• LocalStorage, sessionStorage
• IndexedDB

Animation

• Bezier curve
• CSS-animations
• JavaScript animations

Web components

• From the orbital height
• Custom elements
• Shadow DOM and events
• Template element
• Shadow DOM slots, composition
• Shadow DOM styling
• Shadow DOM and events

Regular expressions

• Patterns and flags
• Methods of RegExp and String
• Character classes
• Escaping, special characters
• Sets and ranges [...]
• Quantifiers +, *, ? and {n}
• Greedy and lazy quantifiers
• Capturing groups
• Backreferences in pattern: \n and \k
• Alternation (OR) |
• String start ^ and finish $
• Multiline mode, flag "m"
• Lookahead and lookbehind
• Infinite backtracking problem
• Unicode: flag "u"
• Unicode character properties \p
• Sticky flag "y", searching at position

[iliakan]

@javascript-tutorial/translate-ru почитайте, что получилось, пожалуйста.

[oshliaer]

На вычитке.

[iliakan]

@javascript-tutorial/translate-ru up =)

[xcurveballx]

@iliakan По вопросу вычитки я думаю так: вычитывать стоит дать или проф. редактору с целью исправления каких-то неточностей/ошибок на проф. уровне или вычитывать следует автору с целью проверить, всё ли так в плане единого авторского стиля и фактического изложения материала.

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

Как вариант, поскольку так или иначе все главы были прочитаны во время перевода и ревью, то можно считать учебник готовым, а дальнейшие правки/улучшения производить ориентируясь на комментарии читателей - кому что непонятно, кто где ошибку заметит и т.д. Как-то так.

[iliakan]

Автор уже проверил =), но любой перевод нуждается в шлифовке, при чтении на свежую голову корявые обороты и тавтологии становятся видны.

[iliakan]

Читаю вот и вижу, где-то фразы недопереведены, где-то оборот не по-русски звучит.

[iliakan]

@javascript-tutorial/translate-ru Может кто-то поучаствовать в вычитке? Внимательно прочитать текст, где надо - улучшить фразы, иногда доперевести по мелочи.

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

[xcurveballx]

@iliakan могу взять раздел Objects: the basics

[iliakan]

@aruseni у вас были очень дельные комментарии по строкам, может быть, вы сможете поучаствовать в вычитке?

Кстати, я сделал механизм перевода картинок (замены фраз в SVG), там местами есть несоответствие текста переведённого тому, что в иллюстрациях.

Можно либо вернуть в тексте англ, либо в картинках перевести (см файл images.yml в корне)

[iliakan]

@xcurveballx вычитал =) Может, регэкспы (если в них разбираешься хорошо)? или Animation?

[aruseni]

@iliakan Спасибо!

Беру Scrolling.

[iliakan]

Картинки я вроде перевёл )

[iliakan]

В переводах много ошибок. Вычитывать необходимо.

[oshliaer]

В переводах много ошибок. Вычитывать необходимо.

Как отправлять PR? На каждую ошибку?

[iliakan]

На статью. Потом я здесь помечу.

[oshliaer]

@iliakan , зацени #446, пожалуйста. Или надо искать только грубые нарушения текста?

[xcurveballx]

@iliakan При попытке открыть по ссылке статью про карринг (напрямую или из содержания в закрепе) - https://github.com/javascript-tutorial/ru.javascript.info/blob/master/1-js/06-advanced-functions/11-currying-partials открывается страница 404. Что-то не так с ссылкой или изменилась структура учебника?

[oshliaer]

@xcurveballx, переименовано без изменений ce7a22a

$user⎇master > git log -p --follow -- 1-js/06-advanced-functions/11-currying-partials

[iliakan]

@xcurveballx да, переименовал, я с сайта всё читаю, поэтому не заметил. Убрал.

[oshliaer]

@iliakan , я читаю с локального сервера только master. Это же верный путь?

[iliakan]

в смысле ветка? ветка master - да, верная.

[xcurveballx]

@iliakan в разделе Data types последние несколько статей не открываются по ссылке - 404.

[iliakan]

@xcurveballx Там статья map/set/weakmap/weakset была разделена на две. Обновил список, сейчас должно быть ок.

[iliakan]

Обновлён раздел "регулярные выражения". Сами темы не поменялись, скорее большой рефакторинг, чтобы сделать всё проще и понятнее. Просьба прочитать, написать если что-то не так.

[ghost]

https://learn.javascript.ru/js
That`s a new link for book "Язык программирования JavaScript" (RU)