diff --git a/rust/agama-lib/share/examples/profile.jsonnet b/rust/agama-lib/share/examples/profile.jsonnet
index 3f2dfc0b77..136d91df9c 100644
--- a/rust/agama-lib/share/examples/profile.jsonnet
+++ b/rust/agama-lib/share/examples/profile.jsonnet
@@ -1,4 +1,18 @@
+// This is a Jsonnet file. Please, check https://jsonnet.org/ for more
+// information about the language.
+// For the schema, see
+// https://github.com/openSUSE/agama/blob/master/rust/agama-lib/share/profile.schema.json
+
+// The "hw.libsonnet" file contains hardware information of the storage devices
+// from the "lshw" tool. It is generated by running as root:
+//
+//   lshw -json -class disk
+//
+// However, it is expected to change in the near future to include information
+// from other subsystems (e.g., network).
 local agama = import 'hw.libsonnet';
+
+// Find the biggest disk which is suitable for installing the system.
 local findBiggestDisk(disks) =
   local sizedDisks = std.filter(function(d) std.objectHas(d, 'size'), disks);
   local sorted = std.sort(sizedDisks, function(x) x.size);