diff --git a/devShells/README.md b/devShells/README.md
new file mode 100644
index 00000000..43067e6b
--- /dev/null
+++ b/devShells/README.md
@@ -0,0 +1,19 @@
+# devShells
+
+This directory contains every derivations for devShells exposed by this flake.
+
+## List of my devShells found in `self.devShells`
+
+| Name | Description |
+| ---- | ----------- |
+| c-lang | c-lang shell to be loaded by my Neovim config dynamically. |
+| csharp | csharp shell to be loaded by my Neovim config dynamically. |
+| flake | Shell providing some utility scripts concerning the main flake. |
+| json | json shell to be loaded by my Neovim config dynamically. |
+| lua | lua shell to be loaded by my Neovim config dynamically. |
+| markdown | markdown shell to be loaded by my Neovim config dynamically. |
+| netdaemon | Shell that makes sure we have the right dotnet-sdk version for NetDaemon development. |
+| node | Shell that provides `bumpNpmDeps`, node and typescript. |
+| rust | rust shell to be loaded by my Neovim config dynamically. |
+| subtitles-dev | Shell that provides the dependencies for my subtitle management scripts. |
+| web | web shell to be loaded by my Neovim config dynamically. |