Merge pull request #79 from gpx1000/update-readme

Update README

Author: gpx1000

README.adoc

@@ -8,12 +8,53 @@ The Khronos Vulkan^®^ Tutorial is based on the "link:https://vulkan-tutorial.co
 
 This repository hosts the contents of the link:https://docs.vulkan.org/tutorial/latest[Khronos Vulkan Tutorial]. The tutorial is part of the link:https://github.com/KhronosGroup/Vulkan-Site[Vulkan Documentation Project].
 
+== Project Structure
+
+The repository is organized into several important directories:
+
+* `en/` - Contains the tutorial content in English, organized by chapters
+* `attachments/` - Contains code examples, shader files, and resources used in the tutorial
+* `images/` - Contains illustrations, diagrams, and screenshots used in the tutorial
+* `scripts/` - Contains utility scripts, including dependency installation scripts
+* `antora/` - Contains configuration files for the Antora documentation system
+
+== Installation Dependencies
+
+The project provides scripts to help you install the necessary dependencies:
+
+=== Linux
+Run the following command to install dependencies on Linux:
+[source,bash]
+----
+./scripts/install_dependencies_linux.sh
+----
+
+This script detects your package manager (apt, dnf, pacman) and installs the required dependencies, including:
+* Build essentials (gcc, cmake, ninja-build)
+* GLFW, GLM, tinyobjloader, stb
+* X Window System dependencies
+
+It also provides instructions for installing the Vulkan SDK.
+
+=== Windows
+Run the following command to install dependencies on Windows:
+[source,batch]
+----
+scripts\install_dependencies_windows.bat
+----
+
+This script uses vcpkg to install the required dependencies, including:
+* GLFW, GLM, tinyobjloader, stb
+
+You will also need to install the Vulkan SDK separately from https://vulkan.lunarg.com/.
+
 == License
 
 The contents of this repository are licensed as https://creativecommons.org/licenses/by-sa/4.0/[CC BY-SA 4.0], unless stated otherwise.
 By contributing to this repository, you agree to license your contributions to the public under that same license.
 
-The code listings in the `code` directory are licensed as https://creativecommons.org/publicdomain/zero/1.0/[CC0 1.0 Universal].
+The code listings in the `attachments` directory are licensed as
+https://creativecommons.org/publicdomain/zero/1.0/[CC0 1.0 Universal].
 By contributing to that directory, you agree to license your contributions to the public under that same public domain-like license.
 
 == Contributing