diff --git a/templates/clan/default/modules/gnome.nix b/templates/clan/default/modules/gnome.nix
index bcbc5a148..b4f77768d 100644
--- a/templates/clan/default/modules/gnome.nix
+++ b/templates/clan/default/modules/gnome.nix
@@ -1,3 +1,17 @@
+/*
+  This is an example of a simple nixos module:
+
+  Enables the GNOME desktop environment and the GDM display manager.
+
+  To use this module, import it in your machines NixOS configuration like this:
+
+  ```nix
+  imports = [
+    modules/gnome.nix
+  ];
+  ```
+*/
+{ ... }:
 {
   services.xserver.enable = true;
   services.xserver.desktopManager.gnome.enable = true;