mirror of
https://github.com/dexoron/dcr.git
synced 2026-10-21 16:39:37 +00:00
Dexoron
210e82f026
- 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
103 lines
6.5 KiB
Markdown
103 lines
6.5 KiB
Markdown
# 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` в соответствующем репозитории.
|