diff --git a/docs/development/best-practices.md b/docs/development/best-practices.md
index 6da69b62360cc583e658cb022518d9d5f92ec55e..e92fae7159d0b2d6ad5749547490837b88698ba1 100644
--- a/docs/development/best-practices.md
+++ b/docs/development/best-practices.md
@@ -116,6 +116,11 @@ try {
 }
 ```
 
+### Aysnc functions
+
+Never use `Promise.resolve` in async functions.
+Never use `Promise.reject` in async functions, instead throw an `Error` class type.
+
 ### Dates and times
 
 Use [`Luxon`](https://www.npmjs.com/package/luxon) to handle dates and times.