Added:

- Custom build flags: `build.cflags` and `build.ldflags`
- Recursive source discovery inside `src/`
- Path dependencies with auto include/lib resolution and `dcr.lock` generation (experimental)
- Add docs/index.md and docs/dcr-toml.md

docs/ru/FAQ_ru.md

@@ -0,0 +1,102 @@
+# FAQ
+
+## В чем суть проекта?
+`dcr` - это инструмент для управления C/C++ проектами и их зависимостями.
+Он вдохновлен Cargo, но не является аналогом Makefile, CMake или других классических систем сборки.
+
+Цель проекта - дать более простую и удобную в настройке среду для разработки.
+
+## Как разрабатывается проект?
+Проект написан на Rust и в основном развивается одним разработчиком - Dexoron.
+
+В работе используются ИИ-инструменты, но они не пишут проект целиком: их роль - помощь с отдельными задачами (например, советы, проверка формулировок, переводы и т.д.).
+
+## Какие инструменты используются для разработки?
+Основной стек разработки:
+- `RustRover` 2025 - IDE для разработки.
+- `Codex` (`GPT-5.3-Codex (medium)`) - основной ИИ-инструмент, интегрированный через JetBrains AI Chat.
+- `Rust` - основной язык проекта.
+- `Cargo` - инструмент сборки, тестов и управления зависимостями Rust-проектов.
+
+## Проект открытый?
+Да, проект открыт (Open Source).
+Вы можете предлагать идеи, находить ошибки и вносить изменения в код.
+
+Проект распространяется по лицензии MIT (см. `LICENSE`).
+
+## Как внести вклад?
+Спасибо за желание помочь проекту.
+Вы можете:
+- помочь с кодом;
+- помочь с переводом;
+- помочь с документацией;
+- предложить идею или сообщить о баге.
+
+### Если вы хотите внести изменения (код, перевод, документация)
+1. Сделайте форк нужного репозитория: `dexoron/dcr` (основной проект) или `dexoron/dcr-site` (сайт проекта).
+2. Внесите изменения с учетом правил из `CONTRIBUTING.md`.
+3. Отправьте изменения в свой форк.
+4. Создайте Pull Request.
+5. Дождитесь ревью.
+
+### Если вы хотите сообщить о проблеме или предложить идею
+1. Откройте нужный репозиторий: `dexoron/dcr` или `dexoron/dcr-site`.
+2. Перейдите во вкладку `Issues`.
+3. Создайте Issue и укажите тип (баг, предложение, вопрос/помощь).
+4. Опишите проблему или идею кратко и понятно.
+5. Дождитесь обратной связи.
+
+## Как установить `dcr`?
+Актуальные способы установки зависят от текущей версии проекта.
+Рекомендуемый путь:
+- проверьте инструкции в `README.md`;
+- если готового пакета для вашей платформы нет, соберите проект из исходников через `cargo build --release`.
+
+## Как быстро начать работу?
+Минимальный сценарий:
+1. Установите `dcr`.
+2. Создайте проект (или перейдите в существующий C/C++ проект).
+3. Инициализируйте конфигурацию `dcr`.
+4. Добавьте зависимости проекта.
+5. Запустите сборку через `dcr`.
+
+Подробные команды и примеры смотрите в `README.md` и документации проекта.
+
+## На какой стадии проект?
+`dcr` активно развивается.
+Это означает, что интерфейсы и поведение некоторых функций могут меняться между версиями.
+
+Перед обновлением рекомендуется читать changelog и проверять заметки к релизу.
+
+## С какими системами работает `dcr`?
+`dcr` ориентирован на современные среды разработки C/C++.
+Фактическая совместимость зависит от версии `dcr`, операционной системы и используемого toolchain.
+
+Перед началом работы проверьте в документации:
+- поддерживаемые ОС;
+- поддерживаемые компиляторы и линкеры;
+- ограничения конкретной версии.
+
+## Чем `dcr` отличается от Make/CMake?
+`dcr` не пытается быть прямой заменой Make/CMake.
+Главный фокус `dcr` - упростить управление проектом и зависимостями в стиле, близком к опыту Cargo.
+
+Если вам нужен низкоуровневый полный контроль над процессом сборки, классические инструменты могут быть привычнее.
+Если нужна более простая и единообразная модель конфигурации - `dcr` может быть удобнее.
+
+## Где смотреть документацию и примеры?
+Основные источники:
+- `README.md` в репозитории;
+- документация проекта (смотреть сайт проекта);
+- `Issues` для известных проблем и обсуждений;
+
+## Как правильно сообщить о баге?
+Чтобы баг-репорт можно было быстро воспроизвести, укажите:
+1. Версию `dcr`.
+2. ОС и версию компилятора/toolchain.
+3. Шаги воспроизведения.
+4. Ожидаемое поведение.
+5. Фактическое поведение и текст ошибки.
+6. Минимальный пример проекта (по возможности).
+
+Баги и проблемы отправляйте через `Issues` в соответствующем репозитории.