Skip to content

chore(docs): added a migration guide to angular 20#1617

Draft
rmnturov wants to merge 8 commits into
mainfrom
chore/migration-guide-rturov
Draft

chore(docs): added a migration guide to angular 20#1617
rmnturov wants to merge 8 commits into
mainfrom
chore/migration-guide-rturov

Conversation

@rmnturov
Copy link
Copy Markdown
Contributor

@rmnturov rmnturov commented Jun 3, 2026

Prose revision of the Angular 20 migration guide — a revised take on PR #1605.

Changes

  • migration-prose.ru.md — revised migration guide (RU)
  • angular-20-breaking-changes-prose.ru.md — revised breaking changes page (RU)
  • structure.ts — registers the new pages

How to review

Compare this branch against chore/migration-guide to see before/after on the dev docs site.

image

TODO

If the Russian revision is approved, apply the same edits to the English versions.

@rmnturov rmnturov self-assigned this Jun 3, 2026
- Fixed 'Сore' → 'Core' (Cyrillic C to Latin)
- Added 'двухаргументной' and 'инпуты' to ru.json dictionary
@rmnturov rmnturov changed the base branch from chore/migration-guide to main June 3, 2026 07:33
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jun 3, 2026

Visit the preview URL for this PR (updated for commit fc27938):

https://koobiq-next--prs-1617-lpdde7bn.web.app

(expires Wed, 10 Jun 2026 10:42:38 GMT)

🔥 via Firebase Hosting GitHub Action 🌎

Sign: c9e37e518febda70d0317d07e8ceb35ac43c534c

| @angular-builders/jest | 20.0.0 | |
| @angular-eslint/\* | ^20.7.0 | |
| @typescript-eslint/\* | ^8.59.3 | |
| ESLint | 8.57.1 | остается на текущей версии |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

можно не упоминать

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lskramarov нужно твоё ревью предложения от Никиты

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@rmnturov спасибо! я тоже вижу этот комментарий.


В корне каждой библиотеки/приложения добавлены отдельные файлы **tsconfig.spec.json**, расширяющие конфиг из корня workspace. Пути **test.options.tsConfig** в angular.json теперь разрешаются от корня проекта (требуется миграциями схематиков v20).

Юнит-тесты схематиков обновлены под вывод **@schematics/angular:application** из v20 (имена файлов изменились с app.component.html → app.html).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

можно не упоминать

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lskramarov нужно твоё ревью предложения от Никиты

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@rmnturov спасибо! я тоже вижу этот комментарий.

Comment thread docs/guides/angular-20-breaking-changes-prose.ru.md Outdated
Co-authored-by: Nikita Guryev <nikgurv@gmail.com>

**Dropdown**. KbqDropdown.backdropClass возвращен к @Input в соответствии с интерфейсом KbqDropdownPanel; конструктор KbqDropdownContent больше не принимает ComponentFactoryResolver (удален в Angular 20).

**Input number**. Убрано приведение через `@Attribute('step' | 'big-step' | 'min' | 'max')` в конструкторе — те же значения по умолчанию задаются через `input(..., { transform: numberAttribute })`; привязки `[step]="..."` по-прежнему работают.
Copy link
Copy Markdown
Contributor

@NikGurev NikGurev Jun 3, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ложная информация. Надо удалить из текста либо действительно поправить

Image

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@lskramarov нужно твоё ревью предложения от Никиты

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@rmnturov спасибо! я тоже вижу этот комментарий.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR revises and expands the Angular 20 migration documentation (both “short/bulleted” and “prose” variants in RU/EN), and wires the new pages into the docs site navigation with an option to keep some pages routable but hidden from nav.

Changes:

  • Adds new “prose” migration and breaking-changes pages (RU/EN) and updates existing migration guides with an expanded Angular 20 section.
  • Registers the new docs pages in the docs site structure and hides selected pages from welcome/sidenav while keeping them routable.
  • Updates cspell locale dictionaries to accommodate newly introduced terminology in RU docs and tooling references in EN docs.

Reviewed changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 10 comments.

Show a summary per file
File Description
tools/cspell-locales/ru.json Adds RU dictionary words used by the updated migration/breaking-changes docs.
tools/cspell-locales/en.json Adds “packagr” to avoid spellcheck noise in tooling docs.
docs/guides/migration.ru.md Updates the Angular 20 upgrade section and links to the breaking-changes page.
docs/guides/migration.en.md Updates the Angular 20 upgrade section and links to the breaking-changes page.
docs/guides/migration-prose.ru.md Adds a new RU “prose” migration guide page.
docs/guides/migration-prose.en.md Adds a new EN “prose” migration guide page.
docs/guides/angular-20-breaking-changes.ru.md Adds a RU Angular 20 breaking-changes page.
docs/guides/angular-20-breaking-changes.en.md Adds an EN Angular 20 breaking-changes page.
docs/guides/angular-20-breaking-changes-prose.ru.md Adds a RU “prose” breaking-changes page.
docs/guides/angular-20-breaking-changes-prose.en.md Adds an EN “prose” breaking-changes page.
CHANGELOG.md Removes the entire 20.0.0 changelog entry (potentially unintended for this PR scope).
apps/docs/src/app/structure.ts Registers the new pages and introduces a hidden flag for docs navigation.
apps/docs/src/app/components/welcome/welcome.component.ts Filters out hidden docs items from the welcome page listing.
apps/docs/src/app/components/sidenav/sidenav.ts Filters out hidden docs items from the sidenav tree.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/guides/migration-prose.ru.md Outdated
Comment thread docs/guides/migration-prose.en.md Outdated
Comment thread docs/guides/migration-prose.ru.md Outdated
Comment thread docs/guides/angular-20-breaking-changes-prose.ru.md Outdated
Comment thread docs/guides/angular-20-breaking-changes-prose.ru.md Outdated
Comment thread docs/guides/angular-20-breaking-changes.ru.md Outdated
Comment thread docs/guides/angular-20-breaking-changes.en.md Outdated
Comment thread docs/guides/angular-20-breaking-changes-prose.ru.md Outdated
Comment thread docs/guides/angular-20-breaking-changes-prose.en.md Outdated
Comment thread CHANGELOG.md
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@lskramarov lskramarov changed the title chore(docs): prose revision of v20 migration guide chore(docs): added a migration guide to angular 20 Jun 5, 2026
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@lskramarov lskramarov force-pushed the chore/migration-guide-rturov branch from ad2828a to 6ed5fe5 Compare June 5, 2026 09:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants