From:To:
11¶ # Next.js
22
33 **Что это.** Фреймворк поверх React: маршруты, серверный рендер, сборка. Сам проект описывает себя так: «The React Framework».
44
55 **Возраст.** Репозиторий на GitHub заведён 5 октября 2016 года. Проект ведёт компания Vercel.
66
77 **Размер.** 142 100 звёзд, 31 900 форков на сентябрь 2026.
8+¶ ## Привычки, описанные им самим
9+
10+ Правила у Next.js разложены по нескольким файлам: короткий [contributing.md](https://github.com/vercel/next.js/blob/canary/contributing.md) и каталог `contributing/` с разделами `core`, `docs`, `repository`, `turbopack`. Каталога `examples` там сейчас нет.
11+
12+ **Правки-мелочи не приветствуются — и причина названа прямо:**
13+
14+ > Every pull request has to be reviewed by a maintainer… **Reviewer attention is the scarcest resource the project has.** Trivial PRs such as typo fixes, formatting, or code style changes are likely to be closed.
15+
16+ *Каждый PR должен прочитать мейнтейнер. Внимание ревьюера — самый дефицитный ресурс проекта. Мелкие правки вроде опечаток, форматирования и стиля кода, скорее всего, закроют.*
17+
18+ Для документации в `docs/` исключение: там к таким правкам «более открыты».
19+
20+ **Новая возможность начинается не с кода, а с обсуждения:**
21+
22+ > You do not need permission to work on an issue. For new **features**, open a discussion and get the proposal accepted first.
23+
24+ *Разрешения работать над задачей не нужно. Для новых возможностей сначала откройте обсуждение и добейтесь принятия предложения.*
25+
26+ Объяснение — в `contributing/core/adding-features.md`: «Any feature added to Next.js is likely to be around for a while and _has to be maintained_» (*любая добавленная возможность останется надолго, и её придётся поддерживать*).
27+
28+ **Описание PR пишет человек**, даже если код помогал писать ИИ:
29+
30+ > …you must review and deeply understand the contributions you are making. For this reason, **pull request descriptions from external contributors must be written by a human**.
31+
32+ *Вы обязаны проверить и глубоко понимать то, что присылаете. Поэтому описания PR от внешних участников должны быть написаны человеком.*
833¶ ## Привычки, видные по переписке
934
1035 Задача с сорока тремя комментариями живёт пять месяцев без ответа команды, пока её не берёт один человек; зато когда берёт — ревью идёт быстро и по существу (один вопрос, один ответ, влито через три дня). О выкате правки в канарейку приходят сказать в ту же задачу, где ждали.
1136
1237 Минусы под комментариями «same issue» — тоже часть нравов этой площадки.
38+¶ ## Мелкие правила, по которым узнаётся свой
39+
40+ **Ветка одна — `canary`:** «All pull requests should be opened against `canary`», из неё регулярно публикуется npm-тег `@canary`. Стабильный канал выходит по semver отдельно.
41+
42+ **Коммиты подписываются ключом, и sign-off не считается:**
43+
44+ > Unsigned commits will be rejected by the repository rules… A `Signed-off-by` line in the commit message is not enough to satisfy this requirement.
45+
46+ *Неподписанные коммиты отклонят правила репозитория. Строки `Signed-off-by` в сообщении недостаточно.*
47+
48+ Формата сообщения коммита в правилах нет — в инструкции просто `git commit -m "DESCRIBE_YOUR_CHANGES_HERE"`.
49+
50+ **Линтеры — три:** ESLint, Prettier и alex (проверка языка в текстах). Проверка — `pnpm lint`, автопочинка — `pnpm lint-fix`, для документации — `pnpm prettier-fix`.
51+
52+ **Тесты — на TypeScript, из шаблона:** заготовку создаёт `pnpm new-test`, новые e2e-тесты идут через `nextTestSetup` в изолированную установку. Правило, которое многие только подразумевают:
53+
54+ > When applying a fix, ensure the test fails without the fix.
55+
56+ *Чиня баг, убедитесь, что без починки тест падает.*
57+
58+ Каждой новой ошибке или предупреждению положена ссылка на описание — `pnpm new-error`.
59+
60+ Как получить права на запись, не написано; `CODEOWNERS` — один комментарий со ссылкой на справку GitHub.
61+¶ ## Чего ждать, если придёте со своей правкой
62+
63+ Всё ниже — из `contributing.md`, `contributing/repository/triaging.md` и шаблона PR самого проекта.
64+
65+ **Смотрят всё:** «Repository maintainers triage every issue and PR opened in the repository».
66+
67+ **Чеклист PR зависит от типа.** Для бага: связанная задача через `fixes #number`, тесты, ссылка в тексте ошибки. Для возможности: принятое обсуждение, e2e-тесты, документация, телеметрия.
68+
69+ **Багрепорты закрывает бот:**
70+
71+ > …**if the reproduction is missing or insufficient, the issue is automatically closed**, and a comment is added with a correct course of action.
72+
73+ *Если воспроизведение отсутствует или недостаточно, задача закрывается автоматически, а в комментарии объясняют, что делать.*
74+
75+ Метка `please add a complete reproduction` даёт 2 дня, `please verify canary` и `please simplify reproduction` — 14 дней бездействия, потом закрытие. Зато подтверждённая задача получает метку `linear: …` и «never become stale».
76+
77+ **Закрытое запирается через две недели тишины**; переоткрыть можно в течение 14 дней комментарием, где есть `Reopen:` и причина.
78+
79+ О CLA и DCO в собранных файлах ни слова. Документацию смотрят команды Next.js и Developer Experience; предпросмотра нет — «The underlying docs code lives in a private codebase that is synced to the Next.js public repo».
1380¶ ## Кто в кадре
1481
1582 Люди, встреченные в наших разборах этого проекта. Черта называется только вместе с поступком — с датой и ссылкой. Ник — главный, имя — из профиля; нет имени в профиле — только ник.
1683
1784 ### feugy — Damien Simonin Feugas
1885
1986 Три захода на одну поломку за два месяца:
2087
2188 - 07.07.2023 — [PR #52393](https://github.com/vercel/next.js/pull/52393), влит 12.07;
2289 - 24.07.2023 — сам пришёл в чужую задачу и **уменьшил ценность своей же правки**: «unfortunately, #52393 only helps with testing server only code… It does not help with testing RSC»;
2390 - 04.08.2023 — [PR #53578](https://github.com/vercel/next.js/pull/53578), «another attempt», влит 16.08;
2491 - 01.09.2023 — [PR #54891](https://github.com/vercel/next.js/pull/54891), 54 файла, +393/−142, в заметках ревьюерам: «Hopefully this is the last attempt, and a successful one».
2592
2693 ### huozhi — Jiachi Liu
2794
2895 В команде Vercel. 01–04.09.2023 — ревью [#54891](https://github.com/vercel/next.js/pull/54891): один вопрос по существу («значит, под Node тесты уже не запустить?»), проверка ответа своими руками («Found this transform won't apply when `jest` condition is true, makes sense») и вливание.
2996
3097 ### leerob — Lee Robinson
3198
3299 04.09.2023 — [пришёл в закрытую и запертую задачу](https://github.com/vercel/next.js/issues/47448#issuecomment-1705573492) сказать, что правка в канарейке: «Please let us know if it's working for y'all 🙏 Appreciate your patience».
33100
34101 ### Очередь в #47299
35102
36103 **andremendonca** — André Mendonça — 19.03.2023 открыл задачу про тесты с `generateMetadata`. **defrex** — Aron Jones — 23.03.2023 открыл соседнюю, [#47448](https://github.com/vercel/next.js/issues/47448).
37104
38105 **red2678** — 26.05.2023, [четыре слова](https://github.com/vercel/next.js/issues/47299#issuecomment-1564181473): «Three months later. ...rip»; 07.07.2023 вступился за тех, кому ставят минусы: «We are consumers of this, not the maintainers».
39106
40107 **ctsstc** — 15.06.2023, [про первый тест в новом проекте](https://github.com/vercel/next.js/issues/47299#issuecomment-1592148999): «the first test you write blows up and SWC gives you no useful message to go off of». Жалоба не на баг, а на сообщение об ошибке.
41108¶ ## Разборы, где встречается
42109
43110 - **«Пакет, который ломается нарочно»** — `server-only` в тестах Next.js: пять месяцев тишины, три захода одного человека и правка в канарейке.
44111
45112 ---
46113
47− *Карточка собрана 02.09.2026 из открытых источников: репозиторий и переписка в PR и задачах. Правила проекта (CONTRIBUTING и подобные) в карточку ещё не разобраны — раздел «Привычки, описанные им самим» появится, когда будут. Фотографий и личных данных здесь нет и не будет. Нашли неточность или хотите, чтобы вас убрали, — напишите, поправим без вопросов.*
114+ *Карточка собрана 02.09.2026 из открытых источников: репозиторий, документация проекта, переписка в PR и задачах. Фотографий и личных данных здесь нет и не будет. Нашли неточность или хотите, чтобы вас убрали, — напишите, поправим без вопросов.*