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.

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)
+<!-- **More details:** See [cycle_detection.en.md](doc/cycle_detection.en.md) -->

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):
+<!-- For richer logging, analytics, or UI overlays, use an advanced observer such as [talker_cherrypick_logger](../talker_cherrypick_logger): -->
 
 ```dart
 import 'package:cherrypick/cherrypick.dart';

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)
+<!-- * Circular Dependency Detection [(En)](doc/cycle_detection.en.md)[(Ru)](doc/cycle_detection.ru.md) -->

website/docs/using-annotations.md

@@ -125,7 +125,9 @@ abstract class AppModule {
 
 ## References
 
+<!--
 - [Full annotation reference (en)](doc/annotations_en.md)
 - [cherrypick_annotations/README.md](../cherrypick_annotations/README.md)
 - [cherrypick_generator/README.md](../cherrypick_generator/README.md)
 - See the [`examples/postly`](../examples/postly) for a full working DI+annotations app.
+-->

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',

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)
+<!-- **Подробнее:** смотрите [cycle_detection.ru.md](doc/cycle_detection.ru.md) -->

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):
+<!-- Для более гибкого логирования или UI-оверлеев можно использовать observer наподобие [talker_cherrypick_logger](../talker_cherrypick_logger): -->
 
 ```dart
 import 'package:cherrypick/cherrypick.dart';

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)
+<!-- * Обнаружение циклических зависимостей [(En)](doc/cycle_detection.en.md)[(Ru)](doc/cycle_detection.ru.md) -->

website/i18n/ru/docusaurus-plugin-content-docs/current/using-annotations.md

@@ -96,7 +96,9 @@ abstract class AppModule {
 
 ## Ссылки
 
+<!--
 - [Подробнее про аннотации (en)](doc/annotations_en.md)
 - [cherrypick_annotations/README.md](../cherrypick_annotations/README.md)
 - [cherrypick_generator/README.md](../cherrypick_generator/README.md)
 - Полный пример: [`examples/postly`](../examples/postly)
+-->