Merge pull request #323 from wbstack/tarrow-patch-1

Update build-scripts.md

Author: rosalieper

docs/build-scripts.md

@@ -1,5 +1,12 @@
 ## Build scripts
 
+### Overview
+```mermaid
+graph TD
+    A[wikiman.yaml]-->|wikiman|B[pacman.yaml]
+    B-->|pacman|C[dist folder with things in it]
+```
+
 ### sync.sh
 
 This script will resync the `dist` directory.
@@ -12,6 +19,10 @@ This is made up of a series of steps:
 - `04-docker-compose`: Perform a composer install
 - `05-docker-entrypoint-overrides`: Add the WBStack shims to MediaWiki entrypoints
 
+Assuming neither `dist-persist` directory or `pacman.yaml` have changed then running this script should almost be a no-op. The only files we expect to change are composer autoload files and composer's own vendor folder.
+
+There is a GitHub Action [Workflow](../.github/workflows/wbstack.sync.check.yml) running to attempt to ensure that `sync.sh` has been run on every commit so that the dist directory does not get out of sync from what it is built from.
+
 ### wikiman & pacman
 
 `wikiman` is a MediaWiki specific yaml generator for pacman.