From 1479d2549b4f71478e8313ed15eb0bf346b8d1bc Mon Sep 17 00:00:00 2001
From: muczc1wek <110698397+muczc1wek@users.noreply.github.com>
Date: Thu, 4 Jul 2024 21:47:00 +0200
Subject: [PATCH] [General] Improve VDFS article

---
 docs/zengin/general_info/vdfs.md | 38 +++++++++++++++++++++-----------
 1 file changed, 25 insertions(+), 13 deletions(-)

diff --git a/docs/zengin/general_info/vdfs.md b/docs/zengin/general_info/vdfs.md
index 40cd58b455..6f285a5b36 100644
--- a/docs/zengin/general_info/vdfs.md
+++ b/docs/zengin/general_info/vdfs.md
@@ -1,24 +1,36 @@
 ---
 title: VDFS virtual file system
 ---
-# VDFS
+# VDFS virtual file system
 
 VDFS is the virtual file system used by ZenGin to distribute and store many, but not all, game assets.
 
-## Tools
+!!! Example "Learn more"
+    If you want a more technical documentation of the VDFS format, you can find it on [ZenKit site](https://zk.gothickit.dev/engine/formats/vdf/).
 
-The community created variety of different modding tools for work with VDFS volumes over the times, such as:
+## Loading
+
+### VDF
+`.vdf` files can usually be found in the `Data/` directory of Gothic installations and the game loads them automatically.
+
+Volumes are loaded based on the [timestamp](../tools/vdfs_tools/gothic_vdfs.md#viewer) specified inside the `.vdf` file. The volumes with the latest timestamp are loaded first.
 
-[**GothicVDFS**](../tools/vdfs_tools/gothic_vdfs.md)
 
-- Viewing
-- Extracting
-- Building `.mod` and `.vdf` archives
+### MOD
+`.mod` files are stored in the `Data/ModVDF/` directory and loaded when they are specified in the current game `.ini`.
+```ini title="MyMod.ini"
+// [...]
+[FILES]
+VDF=MyMod.mod  MyMod_Textures.mod
+// [...]
+```
+
+## Tools
+
+The community created variety of different modding tools for work with VDFS volumes over the times, such as:
 
-[**VDFS Tool**](../tools/vdfs_tools/vdfs_tool.md)
+### [GothicVDFS](../tools/vdfs_tools/gothic_vdfs.md)
+Most popular tool for working with VDFS volumes. Allows viewing, extracting and building `.vdf` and `.mod` archives, and has CLI interface.
 
-- Viewing
-- Extracting
-- Building
-- Optimizing
-- Compressing `.mod` and `.vdf` archives
+### [VDFS Tool](../tools/vdfs_tools/vdfs_tool.md)
+New tool for working with VDFS volumes, created to support features introduced by [Union](../union/index.md). Apart from viewing, extracting and building `.vdf` and `.mod` archives, it also supports optimizing and compressing them.
\ No newline at end of file