ci(build.yml): update comments for clarity and consistency

ci(build.yml): add detailed comments explaining each step in the build process
ci(build.yml): correct comment about MSBuild property precedence and toolset version
ci(build.yml): update artifact collection comments to reflect current directory structure
ci(build.yml): add comments explaining the purpose of the release job

Author: Fabio3rs

.github/workflows/build.yml

@@ -23,8 +23,8 @@ jobs:
           submodules: recursive
 
       # -------------------------------------------------------------------
-      # Instala o toolset v141 (VS 2017) + suporte a XP no VS 2022 presente
-      # no runner. O componente WinXP habilita o v141_xp usado pelo premake.
+      # Install v141 (VS 2017) toolset and WinXP support on the runner.
+      # The WinXP component provides the v141_xp toolset required by premake.
       # -------------------------------------------------------------------
       - name: Install v141_xp toolset
         shell: cmd
@@ -38,17 +38,18 @@ jobs:
         # retornar código != 0, o que torna o problema visível nos logs.
 
       # -------------------------------------------------------------------
-      # Gera os projetos VS2015 via Premake (o .exe já está no repo).
-      # O premake define PlatformToolset=v140_xp nos .vcxproj; vamos
-      # sobrescrever isso no MSBuild mais abaixo — sem tocar no premake5.lua.
+      # Generate VS2015 project files using Premake (premake5.exe included
+      # in the repository).
+      # Premake sets PlatformToolset=v140_xp in the .vcxproj files; this is
+      # overridden when invoking MSBuild below without modifying premake5.lua.
       # -------------------------------------------------------------------
       - name: Generate project files (vs2015)
         shell: cmd
         run: premake5.exe vs2015 --outdir=build_temp
 
       # -------------------------------------------------------------------
-      # Configura o ambiente MSVC para o toolset 14.16 (VS 2017 / v141).
-      # Necessário para que o msbuild encontre o compilador correto.
+      # Configure MSVC environment for toolset 14.16 (VS 2017 / v141).
+      # Required so msbuild can locate the correct compiler and toolset.
       # -------------------------------------------------------------------
       - name: Setup MSVC environment (v141)
         uses: ilammy/msvc-dev-cmd@v1
@@ -57,16 +58,12 @@ jobs:
           toolset: 14.16   # toolset do VS 2017
 
       # -------------------------------------------------------------------
-      # Compila sobrescrevendo o PlatformToolset para v141_xp.
-      #
-      # Por que funciona sem mexer nos .vcxproj:
-      #   O MSBuild permite que qualquer propriedade definida em /p: na linha
-      #   de comando tenha precedência sobre o valor do arquivo de projeto.
-      #   "v141_xp" é exatamente o mesmo toolset que você confirmou funcionar
-      #   ao alterar manualmente pelo Visual Studio 2017.
-      #
-      # /m  → paralelismo (usa todos os núcleos do runner).
-      # /v:m → verbosidade minimal para logs legíveis.
+      # Build and override PlatformToolset to v141_xp via MSBuild.
+      # MSBuild command-line properties passed with /p: take precedence over
+      # project file values. v141_xp is the v141 toolset variant that provides
+      # WinXP support.
+      # /m    -> enable parallel build using all available cores.
+      # /v:m  -> minimal verbosity for concise logs.
       # -------------------------------------------------------------------
       - name: Build (${{ matrix.configuration }})
         shell: cmd
@@ -78,32 +75,32 @@ jobs:
             /m /v:m
 
       # -------------------------------------------------------------------
-      # Coleta os binários gerados.
-      # Estrutura de saída do premake: bin/ (modloader.asi) e
-      # bin/plugins/gta3/*.dll para os plugins.
+      # Collect generated binaries.
+      # Premake output layout: bin/ (modloader.asi) and
+      # bin/plugins/gta3/*.dll for plugins.
       # -------------------------------------------------------------------
       - name: Collect artifacts
         shell: pwsh
         run: |
           $cfg  = "${{ matrix.configuration }}"
           $dest = "artifacts\modloader-$cfg"
 
-          # ASI principal
+          # Main ASI binary
           New-Item -ItemType Directory -Force -Path "$dest" | Out-Null
           Copy-Item "bin\modloader.asi"         "$dest\" -ErrorAction SilentlyContinue
 
-          # Plugins gta3
+          # GTA3 plugins
           $pluginSrc = "bin\plugins\gta3"
           if (Test-Path $pluginSrc) {
               New-Item -ItemType Directory -Force -Path "$dest\plugins\gta3" | Out-Null
               Copy-Item "$pluginSrc\*.dll" "$dest\plugins\gta3\" -ErrorAction SilentlyContinue
           }
 
-          # PDBs (ficam junto aos binários no mesmo diretório)
+          # PDB files (placed with binaries in the same directory)
           Copy-Item "bin\*.pdb"                    "$dest\" -ErrorAction SilentlyContinue
           Copy-Item "bin\plugins\gta3\*.pdb"       "$dest\plugins\gta3\" -ErrorAction SilentlyContinue
 
-          # Docs / configs de exemplo
+          # Example docs and configuration files
           Copy-Item "doc\config\*.ini.0"                "$dest\" -ErrorAction SilentlyContinue
           Copy-Item "doc\CHANGELOG.md"                  "$dest\" -ErrorAction SilentlyContinue
           Copy-Item "LICENSE"                           "$dest\" -ErrorAction SilentlyContinue
@@ -120,8 +117,8 @@ jobs:
           retention-days: 30
 
   # -----------------------------------------------------------------------
-  # Job extra: cria uma Release no GitHub quando uma tag "v*.*.*" é enviada.
-  # Só roda se o job build (Release) passou.
+  # Extra job: create a GitHub Release when a tag matching v*.*.* is pushed.
+  # Runs only if the build (Release) job completed successfully.
   # -----------------------------------------------------------------------
   release:
     if: startsWith(github.ref, 'refs/tags/v')