Добавляет доку `Базовые операторы в JS` by anton-fomichev · Pull Request #5709 · doka-guide/content

anton-fomichev · 2025-03-10T21:18:49Z

Описание

Добавит нового автора в /people/anton-fomichev
Добавит первую версию статьи. Включает в себя:
- описание терминов "оператор" / "операнд"
- типы операторов
- математика
- работа операторов с объектами
- приоритет операторов
- присваивание
- инкремент и декремент

Closes #5077

Чек-лист

Текст оформлен согласно руководству по стилю
Ссылки на внутренние материалы начинаются со слеша и заканчиваются слэшем либо якорем на заголовок (/css/color/, /tools/json/, /tools/gulp/#kak-ponyat)
Ссылки на картинки, видео и демки относительные (images/example.png, demos/example/, ../demos/example/)

anton-fomichev · 2025-03-10T21:21:49Z

Нужна помощь с заполнением полей keywords и related. В ходе работы наткнулся на следующие страницы в Доке:

Мне кажется, что они хорошо подходят на роль кандидатов в related

js/operators/index.md

vitya-ne · 2025-03-12T07:21:40Z

Привет, спасибо за доку!
Вернусь к более внимательному прочетнию в ближайшее время )

js/operators/index.md

Inventoris

Привет Антон!

Очень круто, спасибо, что сделал для Доки этот чудесный материал ƪ(˘⌣˘)ʃ

Я всё посмотрел, есть несколько глобальных комментов:

Материал большой, развёрнутый, добротный. Это уже не дока, а статья. Поэтому нам нужно оформить её, как статью. Вот полезная документация на тему. Я бы предложил такую структуру:
- Что за операторы?
- Кто такие «оператор» и «операнд»? (туда можно поместить про унарные и бинарные операторы, чтобы не плодить главы).
- Далее главы по каждому типу операторов. Мне нравится, как ты сделал "математика" и "не только математика". Можно, например, присваивание, математика, сравнение, побитам, строки. Давай попробуем объединить всё в простые главы. Что не относится к типам операторов, можно выделить в отдельные.
Главу "как делать не надо" и подобные штучки помещаем в раздел "На практике". Там ты с величины своего опыта советуешь что делать, как делать итд. Очень хорошо, если туда что-то набирается. Вот тут инструкция.
Дока пишется с объяснениями на пальцах буквально. Тут я помогу, но в целом просьба взглянуть на текст с позиции "йоу, чуваки, щас я вам расскажу, что это за грибы такие". Сильно тут не напрягайся, я оставлю комментарии позже или подредактирую с твоего позволения сам. В целом ничего критичного, текст читается весьма легко =)
Начали с того, что рассказываем про базовые операторы, а получился большой материал почти про все. Это хорошо. Давай то, чего не хватает по теме, добавим. Чтобы были все операторы. И сделаем из материала именно не "Базовые операторы в JS", а просто "Операторы".

Итого:

Допиливаем структуру глав.
Добавляем "На практике".
По возможности упрощаем. Например, из "В JavaScript у операторов есть определённый порядок выполнения" можно сделать "Операторы выполняются по очереди". Если сложно, сделаю сам.
Добавляем нехватающих операторов, чтобы получился гайд по всем операторам. И так и называем статью, "операторы".

Если где-то сложно или нужна помощь, маякуй, я приду) У нас получится развёрнутый материал - статья про операторы в JS с лаконичным простым текстом. Красота!

anton-fomichev · 2025-03-19T19:14:06Z

@Inventoris
Мне казалось, что идея в том, чтобы делить статьи на несколько уровней (базовые/углубленные/узкоспециализированные), чтобы направлять аудиторию сразу в нужное место и лучше продвигаться в поиске, например.

Но если делать какую-то общую статью, то как, например, быть с отдельными статьями:

И если делать, то в каких рамках хотелось бы остаться внутри этой статьи?

Note

Тут забавный факт, что изначально я писал именно статью, но её предложили переделать в доку. Из-за этого материала получилось довольно много, хочется просто понять к какому результату хотим прийти в конечном итоге :)

Inventoris · 2025-03-20T07:41:17Z

@Inventoris Мне казалось, что идея в том, чтобы делить статьи на несколько уровней (базовые/углубленные/узкоспециализированные), чтобы направлять аудиторию сразу в нужное место и лучше продвигаться в поиске, например.

Но если делать какую-то общую статью, то как, например, быть с отдельными статьями:

Тернарный оператор,

Логические операторы.

И если делать, то в каких рамках хотелось бы остаться внутри этой статьи?

Note

Тут забавный факт, что изначально я писал именно статью, но её предложили переделать в доку. Из-за этого материала получилось довольно много, хочется просто понять к какому результату хотим прийти в конечном итоге :)

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

Например, есть дока (лучше бы ей быть статьей конечно) про функции, там кратко про стрелочные, чтобы въехать. А для погружения отдельная дока про стрелочные функции.

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

nasty23-star

Привет! Большое тебе спасибо за классный материал!<3
Написала небольшое предложение, посмотри, пожалуйста, вдруг идея понравится.
Апрув!

nasty23-star · 2025-08-11T07:00:08Z

js/operators/index.md

+
+## Кратко
+
+В JavaScript есть несколько базовых операторов, с которыми разработчики сталкиваются постоянно в ходе своей работы. Они позволяют выполнять арифметические действия, изменять значения переменных, а также помогают разработчику упростить некоторые операции в коде.


Может быть, второе слово "разработчик" убрать? мне кажется, по контексту понятно, что речь идёт о разработчике.

Убрал второе упоминание, первое решил оставить. Что скажешь?

…ript"

"Приведение к числу", "Преобразование объектов", "Булевые значения" -> "Преобразование нечисловых типов"

anton-fomichev · 2025-10-22T19:19:21Z

Решил вернуться сюда после перерыва =)

С чего начал:

Перевел материал из doka в article
Убрал лишнее "разработчики", как предложили выше

Не знаю, как лучше подступиться и в какую сторону двигаться. Взглянул спустя время, подумал над материалом и лично мне показалось, что дока выглядит лаконично.

@Inventoris, что думаешь?

anton-fomichev · 2025-10-24T07:36:56Z

@HellSquirrel Привет! Что думаешь по доке? Решил пингануть на всякий, потому что давно пр создавали

Inventoris

Привет =)

Классно, что решил дописать материал, это респект!

Я немного поредачил, напиши, если с чем-то не согласен. И оставил пару комментов снизу, загляни пж:

В остальном всё супер)

Inventoris · 2025-11-01T11:04:08Z

js/operators/index.md

+// 5 5
+```
+
+#### Как делать не надо


А давай вот эту главу переместим в раздел "На практике"? Я думаю вред таких конструкций, о котором ты пишешь здесь, вообще в целом применим к статье как глобальная идея.

Inventoris · 2025-11-01T11:04:56Z

js/operators/index.md

+}
+```
+
+### Подводные камни


А вот это давай добавим в раздел «Подсказки»

github-actions · 2025-11-01T11:08:13Z

Превью контента из 0501167 опубликовано.

anton-fomichev requested review from HellSquirrel, Inventoris, ra1nbow1 and vitya-ne as code owners March 10, 2025 21:18

github-actions bot added js Контент по JavaScript дока Справочный материал labels Mar 10, 2025

vitya-ne assigned anton-fomichev Mar 10, 2025

vitya-ne reviewed Mar 12, 2025

View reviewed changes

js/operators/index.md Outdated Show resolved Hide resolved

vitya-ne reviewed Mar 12, 2025

View reviewed changes

js/operators/index.md Show resolved Hide resolved

vitya-ne reviewed Mar 12, 2025

View reviewed changes

js/operators/index.md Show resolved Hide resolved

vitya-ne reviewed Mar 12, 2025

View reviewed changes

js/operators/index.md Show resolved Hide resolved

This comment was marked as outdated.

Sign in to view

vitya-ne reviewed Mar 14, 2025

View reviewed changes

js/operators/index.md Outdated Show resolved Hide resolved

vitya-ne reviewed Mar 14, 2025

View reviewed changes

js/operators/index.md Outdated Show resolved Hide resolved

vitya-ne reviewed Mar 14, 2025

View reviewed changes

js/operators/index.md Show resolved Hide resolved

vitya-ne reviewed Mar 15, 2025

View reviewed changes

js/operators/index.md Outdated Show resolved Hide resolved

vitya-ne reviewed Mar 15, 2025

View reviewed changes

js/operators/index.md Outdated Show resolved Hide resolved

vitya-ne reviewed Mar 15, 2025

View reviewed changes

js/operators/index.md Outdated Show resolved Hide resolved

vitya-ne reviewed Mar 15, 2025

View reviewed changes

js/operators/index.md Outdated Show resolved Hide resolved

This comment was marked as outdated.

Sign in to view

This comment was marked as resolved.

Sign in to view

vitya-ne approved these changes Mar 17, 2025

View reviewed changes

ra1nbow1 approved these changes Mar 17, 2025

View reviewed changes

anton-fomichev force-pushed the article/operators branch from f650285 to f3008a9 Compare March 17, 2025 11:08

Inventoris reviewed Mar 19, 2025

View reviewed changes

Inventoris removed the дока Справочный материал label Mar 19, 2025

nasty23-star approved these changes Aug 11, 2025

View reviewed changes

anton-fomichev and others added 16 commits October 22, 2025 22:04

Добавит /people/anton-fomichev

e79a478

Добавит черновик статьи

d5cc7a6

Отредактирует статью, сократит размер до 7 минут

c789a3f

Удалит комментарий из статьи

350b60b

Отредактирует статью, расставит акценты

8c2ea01

Изменит description

7896026

Уберет упоминание объектов, добавит секцию "Приведение к числу"

64f6a05

Добавит скрытую секцию "Как работают операторы по спецификации ECMASc…

4024ce7

…ript"

Пофиксит стиль написания

d55ad5e

Переместит "Как работают операторы по спецификации ECMAScript"

5ab1879

Покажет на примере, как + работает по спеке ECMAScript

1d85b79

Перепишет "Как выполнение операторов описывает спецификация ECMAScript"

0c3fc29

Объединит секции внутри "Не только математика"

114f3bf

"Приведение к числу", "Преобразование объектов", "Булевые значения" -> "Преобразование нечисловых типов"

Добавляет доку в индекс JS

a73d83f

Ставит точку в дискришине

ae65a65

Добавит "related" и удалит "keywords"

aae7b75

anton-fomichev force-pushed the article/operators branch from f3008a9 to aae7b75 Compare October 22, 2025 19:04

github-actions bot added the дока Справочный материал label Oct 22, 2025

anton-fomichev added 2 commits October 22, 2025 22:07

Уберёт лишнее "разработчикам"

95313cd

Поменяет doka на article

1fa2aa1

Inventoris added 2 commits November 1, 2025 13:55

Чуть редачит: упрощает, правит списки, добавляет пояснения

d173817

Добавляет отступ

0501167

Inventoris reviewed Nov 1, 2025

View reviewed changes

Inventoris changed the title ~~Добавляет доку "Базовые операторы в JS"~~ Добавляет доку Базовые операторы в JS Nov 1, 2025


		## Кратко

		В JavaScript есть несколько базовых операторов, с которыми разработчики сталкиваются постоянно в ходе своей работы. Они позволяют выполнять арифметические действия, изменять значения переменных, а также помогают разработчику упростить некоторые операции в коде.

Comments

Conversation

anton-fomichev commented Mar 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Описание

Чек-лист

Uh oh!

anton-fomichev commented Mar 10, 2025

Uh oh!

Uh oh!

vitya-ne commented Mar 12, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment was marked as outdated.

This comment was marked as outdated.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as resolved.

Inventoris left a comment

Choose a reason for hiding this comment

Uh oh!

anton-fomichev commented Mar 19, 2025

Uh oh!

Inventoris commented Mar 20, 2025

Uh oh!

nasty23-star left a comment

Choose a reason for hiding this comment

Uh oh!

nasty23-star Aug 11, 2025

Choose a reason for hiding this comment

Uh oh!

anton-fomichev Oct 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

anton-fomichev commented Oct 22, 2025

Uh oh!

anton-fomichev commented Oct 24, 2025

Uh oh!

Inventoris left a comment

Choose a reason for hiding this comment

Uh oh!

Inventoris Nov 1, 2025

Choose a reason for hiding this comment

Uh oh!

Inventoris Nov 1, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Nov 1, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

anton-fomichev commented Mar 10, 2025 •

edited

Loading

anton-fomichev Oct 22, 2025 •

edited

Loading