From 68bc592c88f5df6cb4219e09cd39a89c6f0d8a7c 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

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

diff --git a/website/structure/default.nix b/website/structure/default.nix
index b99cf19..6d0f016 100644
--- a/website/structure/default.nix
+++ b/website/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 = {