From e0a5ae66f6c8067ded8f470598774279382d08f3 Mon Sep 17 00:00:00 2001 From: Sergey Penkovsky Date: Thu, 14 Aug 2025 16:24:57 +0300 Subject: [PATCH] fix(docs): comment out all broken links to allow successful Docusaurus build - Commented out references to non-existent files and examples in both English and Russian documentation: - circular-dependency-detection.md - logging.md - documentation-links.md - using-annotations.md - This fix prevents build failures caused by unresolved links in Docusaurus for both locales. - All offending links are now non-blocking comments, allowing the site to build and deploy successfully until the related pages are added. --- .../docs/advanced-features/circular-dependency-detection.md | 2 +- website/docs/advanced-features/logging.md | 3 ++- website/docs/documentation-links.md | 2 +- website/docs/using-annotations.md | 2 ++ website/docusaurus.config.ts | 4 ++++ .../advanced-features/circular-dependency-detection.md | 2 +- .../current/advanced-features/logging.md | 3 ++- .../current/documentation-links.md | 2 +- .../current/using-annotations.md | 2 ++ 9 files changed, 16 insertions(+), 6 deletions(-) diff --git a/website/docs/advanced-features/circular-dependency-detection.md b/website/docs/advanced-features/circular-dependency-detection.md index d50b32d..08d7e3d 100644 --- a/website/docs/advanced-features/circular-dependency-detection.md +++ b/website/docs/advanced-features/circular-dependency-detection.md @@ -68,4 +68,4 @@ try { } ``` -**More details:** See [cycle_detection.en.md](doc/cycle_detection.en.md) + diff --git a/website/docs/advanced-features/logging.md b/website/docs/advanced-features/logging.md index 30c6d79..42d4cd6 100644 --- a/website/docs/advanced-features/logging.md +++ b/website/docs/advanced-features/logging.md @@ -25,7 +25,8 @@ void main() { ### Example: Advanced Logging with Talker -For richer logging, analytics, or UI overlays, use an advanced observer such as [talker_cherrypick_logger](../talker_cherrypick_logger): +For richer logging, analytics, or UI overlays, use an advanced observer such as [talker_cherrypick_logger](https://pub.dev/packages/talker_cherrypick_logger): + ```dart import 'package:cherrypick/cherrypick.dart'; diff --git a/website/docs/documentation-links.md b/website/docs/documentation-links.md index e03e719..4e3bad4 100644 --- a/website/docs/documentation-links.md +++ b/website/docs/documentation-links.md @@ -4,4 +4,4 @@ sidebar_position: 8 # Documentation Links -* Circular Dependency Detection [(En)](doc/cycle_detection.en.md)[(Ru)](doc/cycle_detection.ru.md) + diff --git a/website/docs/using-annotations.md b/website/docs/using-annotations.md index 46039b1..01427a9 100644 --- a/website/docs/using-annotations.md +++ b/website/docs/using-annotations.md @@ -125,7 +125,9 @@ abstract class AppModule { ## References + diff --git a/website/docusaurus.config.ts b/website/docusaurus.config.ts index b401852..b42bcfb 100644 --- a/website/docusaurus.config.ts +++ b/website/docusaurus.config.ts @@ -89,6 +89,10 @@ const config: Config = { position: 'right', label: 'Docs', }, + { + type: 'localeDropdown', + position: 'right', + }, { href: 'https://github.com/pese-git/cherrypick', label: 'GitHub', diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/advanced-features/circular-dependency-detection.md b/website/i18n/ru/docusaurus-plugin-content-docs/current/advanced-features/circular-dependency-detection.md index 37f8e60..82f86f4 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/advanced-features/circular-dependency-detection.md +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/advanced-features/circular-dependency-detection.md @@ -68,4 +68,4 @@ try { } ``` -**Подробнее:** смотрите [cycle_detection.ru.md](doc/cycle_detection.ru.md) + diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/advanced-features/logging.md b/website/i18n/ru/docusaurus-plugin-content-docs/current/advanced-features/logging.md index 979f8cd..e0a6b77 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/advanced-features/logging.md +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/advanced-features/logging.md @@ -26,7 +26,8 @@ void main() { ### Пример: расширенное логирование через Talker -Для более гибкого логирования или UI-оверлеев можно использовать observer наподобие [talker_cherrypick_logger](../talker_cherrypick_logger): +Для более гибкого логирования или UI-оверлеев можно использовать observer наподобие [talker_cherrypick_logger](https://pub.dev/packages/talker_cherrypick_logger): + ```dart import 'package:cherrypick/cherrypick.dart'; diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/documentation-links.md b/website/i18n/ru/docusaurus-plugin-content-docs/current/documentation-links.md index aa6512d..8779672 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/documentation-links.md +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/documentation-links.md @@ -4,4 +4,4 @@ sidebar_position: 8 # Ссылки на документацию -* Обнаружение циклических зависимостей [(En)](doc/cycle_detection.en.md)[(Ru)](doc/cycle_detection.ru.md) + diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/using-annotations.md b/website/i18n/ru/docusaurus-plugin-content-docs/current/using-annotations.md index 9ec18ab..281c5b5 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/using-annotations.md +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/using-annotations.md @@ -96,7 +96,9 @@ abstract class AppModule { ## Ссылки +