docs(faq): add best practice FAQ about using await with scope disposal

- Added FAQ section in documentation (README and tutorials, EN + RU) recommending always using await when calling CherryPick.closeRootScope, scope.closeScope, or scope.dispose, even if no services implement Disposable.
- Clarifies future-proof resource management for all users.
This commit is contained in:
Sergey Penkovsky
2025-08-04 10:39:36 +03:00
parent a9c95f6a89
commit 547a15fa4e
3 changed files with 27 additions and 0 deletions

View File

@@ -465,6 +465,15 @@ void main() {
---
## FAQ
### В: Нужно ли использовать `await` для CherryPick.closeRootScope(), scope.closeScope() или scope.dispose(), если ни один сервис не реализует Disposable?
**О:**
Да! Даже если в данный момент ни один сервис не реализует Disposable, всегда используйте `await` при закрытии скоупа. Если в будущем потребуется добавить освобождение ресурсов через dispose, CherryPick вызовет его автоматически без изменения завершения работы ваших скоупов. Такой подход делает управление ресурсами устойчивым и безопасным для любых изменений архитектуры.
---
## Полезные ссылки
- [cherrypick](https://pub.dev/packages/cherrypick)