iliakan / es5

Перевод стандарта ES5

ECMAScript 5 с аннотациями

Этот репозитарий представляет собой перевод 5й редакции спецификации ECMA 262. Для лучшего раскрытия важных мест добавлены аннотации -- ссылки на дополнительные ресурсы.

Он выложен в сеть на странице http://es5.javascript.ru.

Поддержка: Илья Кантор [email protected].

Исходный документ находится на http://es5.github.com, оригинальный стандарт -- на http://www.ecma-international.org/publications/standards/Ecma-262.htm.

Как улучшить перевод

Если вы хотели бы прислать исправление или добавить аннотацию:

1. Если у вас ещё нет, зарегистрируйтесь на Github.

2. Используйте GitHub Web UI, чтобы создать свой форк кнопкой Your Fork и склонируйте его на свой диск.

3. Исправьте перевод у себя.

4. Для добавления аннотации -- используйте следующие шаги:

4.1. Чтобы добавить аннотацию, например, для раздела 10.2.1.2 спецификации, создайте файл в директории anno с названием x10.2.1.2.html (обратите внимание на букву x в начале имени файла).

4.2. Добавьте текст в этот файл. Это должен быть фрагмент HTML (не полный документ, т.е. без тегов html, head, и body). Предполагается, что ваша лицензия допускает републикацию и свободное распространение текста без ограничений.

5. Сделайте commit и push вашей копии в форк на GitHub.

6. Пришлите Pull-запрос в перевод ES5, чтобы мы могли добавить ваши изменения.

es5's Issues

Можно ли получить ePub версию?

Добрый день, Илья!

Можно ли получить ePub версию?

Ошибка в переводе

https://es5.javascript.ru/x8.html#x8

Неправильно:
Языковые типы соответствуют значениям, которыми непосредственно манипулирует создатель кода на языке ECMAScript. К типам спецификации относятся: Undefined, Null, Boolean, String, Number и Object.

Правильно:
Языковые типы соответствуют значениям, которыми непосредственно манипулирует создатель кода на языке ECMAScript. К языковым типам относятся: Undefined, Null, Boolean, String, Number и Object.

Соответствие версии редакции

Предлагаю в Readme указывать, какой версии оригинального языка соответствует перевод
Например по этой ссылке:
http://www.ecma-international.org/ecma-262/7.0/index.html
Видно, что оригинал соответствует версии
ECMA-262
7ᵗʰ Edition / June 2016

И вместе с этим убрать ES5 из названия, дабы не привязываться только к старому — стимулировать улучшение перевода до новых версий

Людям важно знать, насколько актуальные данные они получают