diff --git a/docs/services/system.md b/docs/services/system.md
index 9f71e27..8091cf7 100644
--- a/docs/services/system.md
+++ b/docs/services/system.md
@@ -1,11 +1,11 @@
 # System-related configuration
 
 This Ansible playbook can install and configure various system-related things for you.
-All the sections below relates to the host OS instead of docker containers.
+All the sections below relate to the host OS instead of the managed containers.
 
 ### swap
 
-To enable [swap](https://en.wikipedia.org/wiki/Memory_paging) management, add the following configuration to your `vars.yml` file and re-run the [installation](../installing.md) process:
+To enable [swap](https://en.wikipedia.org/wiki/Memory_paging) management (also read more in the [Swap](https://wiki.archlinux.org/title/Swap) article in the [Arch Linux Wiki](https://wiki.archlinux.org/)), add the following configuration to your `vars.yml` file and re-run the [installation](../installing.md) process:
 
 ```yaml
 ########################################################################
@@ -23,8 +23,14 @@ system_swap_enabled: true
 ########################################################################
 ```
 
-By default, swap file size calculated using the following formula: `total RAM * 2 if total RAM <= 2GB, else - 1GB`,
-if you want to set different swap file size, you can set the `system_swap_size` var in megabytes, example (4gb):
+A swap file will be created in `/var/swap` (configured using the `system_swap_path` variable) and enabled in your `/etc/fstab` file.
+
+By default, the swap file will have the following size:
+
+- on systems with `<= 2GB` of RAM, swap file size = `total RAM * 2`
+- on systems with `> 2GB` of RAM, swap file size = `1GB`
+
+To avoid these calculations and set your own size explicitly, set the `system_swap_size` variable in megabytes, example (4gb):
 
 ```yaml
 system_swap_size: 4096