From 63f4fd8e044be0a25b9d739990059300355887b3 Mon Sep 17 00:00:00 2001
From: nathan-pichon <nathan.pichon@strapi.io>
Date: Tue, 24 Jan 2023 11:16:33 +0100
Subject: [PATCH] chore(utils): add async utils doc

---
 docs/docs/core/utils/async.md | 40 +++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 docs/docs/core/utils/async.md

diff --git a/docs/docs/core/utils/async.md b/docs/docs/core/utils/async.md
new file mode 100644
index 0000000000..6fef0e37e0
--- /dev/null
+++ b/docs/docs/core/utils/async.md
@@ -0,0 +1,40 @@
+---
+title: Async utils functions
+tags:
+  - utils
+---
+
+# Async utils
+
+## Summary
+
+Async utils are grouping all function that interact with async stuff like Promises.
+
+## Detailed design
+
+Available functions:
+
+- pipeAsync
+- mapAsync
+- reduceAsync
+
+[See API reference](../../api/Utils) (TODO)
+
+### When to use
+
+Everytime the code has to act with promises and iterate other them, an async utils function should be used.
+
+### Should I add my function here ?
+
+Any util function that manipulates promises can be included in this utils section.
+
+Please consider the next point if a lots of functions are available in the async section.
+
+## Potential improvements
+
+If we begin to use lots of async utils function, we may consider to migrate to a specialized library like [asyncjs](http://caolan.github.io/async/v3/)
+
+## Resources
+
+- [Async file in Strapi](https://github.com/strapi/strapi/blob/9b36c3b10adaa00fd3596853abc63122632c36fe/packages/core/utils/lib/async.js)
+- http://caolan.github.io/async/v3/