diff --git a/src/modules/partition/partition.conf b/src/modules/partition/partition.conf
index 88d7fee98..610fb7b42 100644
--- a/src/modules/partition/partition.conf
+++ b/src/modules/partition/partition.conf
@@ -4,7 +4,14 @@
 efiSystemPartition:     "/boot/efi"
 
 # Make sure an autogenerated swap partition is big enough for hibernation in
-# automated partitioning modes.
+# automated partitioning modes. Swap can be disabled through *neverCreateSwap*.
+#
+# When *ensureSuspendToDisk* is true, swap is never smaller than physical
+# memory, follows the guideline 2 * memory until swap reaches 8GiB.
+# When *ensureSuspendToDisk* is false, swap size scales up with memory
+# size until 8GiB, then at roughly half of memory size.
+#
+#
 # Default is true.
 ensureSuspendToDisk:    true
 
@@ -31,6 +38,7 @@ defaultFileSystemType:  "ext4"
 # and/or your distribution's initramfs solution.
 #
 # BIG FAT WARNING:
+#
 # This option is unsupported, as it cuts out a crucial security feature.
 # Disabling LUKS and shipping Calamares without a correctly configured GRUB2
 # and initramfs is considered suboptimal use of the Calamares software. The