diff --git a/src/docs/favicons.md b/src/docs/favicons.md
new file mode 100644
index 0000000..038f469
--- /dev/null
+++ b/src/docs/favicons.md
@@ -0,0 +1,11 @@
+---
+title: Favicons
+---
+
+the favicons used are based on the recommendations from the [How to Favicon article on evilmartians.com.](https://evilmartians.com/chronicles/how-to-favicon-in-2021-six-files-that-fit-most-needs)
+
+They are placed in `src/assets/images/favicons`, and copied over to the root of the output folder.
+
+There is no automatization in place to create them.
+
+I recommend keeping the file names as they are, since they are referenced like that in different places.