Description

iliakan

opened on Jul 6, 2019

Issue body actions

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

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

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

Можно сделать это локально, установив сервер 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

Activity

1. iliakan

   pinned this issue on Jul 6, 2019
2. iliakan commented on Jul 6, 2019

   

   iliakan

   on Jul 6, 2019

   MemberAuthor

   More actions

   @javascript-tutorial/translate-ru почитайте, что получилось, пожалуйста.
3. oshliaer commented on Jul 9, 2019

   

   oshliaer

   on Jul 9, 2019

   Contributor

   More actions

   На вычитке.
4. iliakan commented on Jul 25, 2019

   

   iliakan

   on Jul 25, 2019

   MemberAuthor

   More actions

   @javascript-tutorial/translate-ru up =)
5. xcurveballx commented on Jul 25, 2019

   

   xcurveballx

   on Jul 25, 2019

   Member

   More actions

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

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

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

   Reacted by Michael Filipenko
6. iliakan commented on Jul 25, 2019

   

   iliakan

   on Jul 25, 2019

   MemberAuthor

   More actions

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

   

   iliakan

   on Jul 26, 2019

   MemberAuthor

   More actions

   Читаю вот и вижу, где-то фразы недопереведены, где-то оборот не по-русски звучит.
8. iliakan commented on Jul 26, 2019

   

   iliakan

   on Jul 26, 2019

   MemberAuthor

   More actions

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

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

   

   xcurveballx

   on Jul 26, 2019

   Member

   More actions

   @iliakan могу взять раздел Objects: the basics
10. iliakan commented on Jul 28, 2019

    

    iliakan

    on Jul 28, 2019

    MemberAuthor

    More actions

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

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

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

    

    iliakan

    on Jul 28, 2019

    MemberAuthor

    More actions

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

    

    aruseni

    on Jul 28, 2019

    Contributor

    More actions

    @iliakan Спасибо!

    Беру Scrolling.
13. iliakan commented on Jul 30, 2019

    

    iliakan

    on Jul 30, 2019

    MemberAuthor

    More actions

    Картинки я вроде перевёл )
14. iliakan commented on Aug 2, 2019

    

    iliakan

    on Aug 2, 2019

    MemberAuthor

    More actions

    В переводах много ошибок. Вычитывать необходимо.
15. oshliaer commented on Aug 2, 2019

    

    oshliaer

    on Aug 2, 2019

    Contributor

    More actions

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

    Как отправлять PR? На каждую ошибку?
16. iliakan commented on Aug 2, 2019

    

    iliakan

    on Aug 2, 2019

    MemberAuthor

    More actions

    На статью. Потом я здесь помечу.
17. oshliaer commented on Aug 12, 2019

    

    oshliaer

    on Aug 12, 2019

    Contributor

    More actions

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

    self-assigned this

    on Aug 13, 2019
19. xcurveballx commented on Aug 17, 2019

    

    xcurveballx

    on Aug 17, 2019

    Member

    More actions

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

    

    oshliaer

    on Aug 18, 2019

    Contributor

    More actions

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

    $user⎇master > git log -p --follow -- 1-js/06-advanced-functions/11-currying-partials
21. iliakan commented on Aug 18, 2019

    

    iliakan

    on Aug 18, 2019

    MemberAuthor

    More actions

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

    Reacted by Alex Ivanov
22. oshliaer commented on Aug 18, 2019

    

    oshliaer

    on Aug 18, 2019

    Contributor

    More actions

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

    

    iliakan

    on Aug 18, 2019

    MemberAuthor

    More actions

    в смысле ветка? ветка master - да, верная.
24. xcurveballx commented on Sep 1, 2019

    

    xcurveballx

    on Sep 1, 2019

    Member

    More actions

    @iliakan в разделе Data types последние несколько статей не открываются по ссылке - 404.
25. iliakan commented on Sep 1, 2019

    

    iliakan

    on Sep 1, 2019

    MemberAuthor

    More actions

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

    Reacted by Curveball
26. iliakan commented on Sep 2, 2019

    

    iliakan

    on Sep 2, 2019

    MemberAuthor

    More actions

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

    unpinned this issue on Oct 24, 2021
29. iliakan

    closed this as completedon Aug 23, 2022

Issue actions