From a483b7e5fab1609162e9f639bd0a7bc7865c26c5 Mon Sep 17 00:00:00 2001
From: valentin gagarin <valentin.gagarin@tweag.io>
Date: Wed, 13 Nov 2024 15:24:41 +0100
Subject: [PATCH] add some documentation

---
 structure/default.nix | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/structure/default.nix b/structure/default.nix
index b99cf197..6d0f0168 100644
--- a/structure/default.nix
+++ b/structure/default.nix
@@ -20,6 +20,20 @@ in
     {
       description = ''
         Named collections of unnamed pages
+
+        Define the content type of a new collection `example` to be `article`:
+
+        ```nix
+        config.collections.example.type = config.types.article;
+        ```
+
+        Add a new entry to the `example` collection:
+
+        ```nix
+        config.collections.example.entry = {
+          # contents here
+        }
+        ```
       '';
       type = with types; attrsOf (submodule ({ name, config, ... }: {
         options = {