modified: .devcontainer/devops-dev/devcontainer.json

modified:   README.md

README.md

@@ -31,8 +31,26 @@ mkdir -p .devcontainer
 curl -sSL https://gitlimbosolutions.com/mf/devcontainers/devops/templates/devcontainer.json -o .devcontainer/devcontainer.json
 ```
 
-This will copy the baseline devcontainer.json into your project. You can then layer project‑specific extensions or settings on top.
+This will copy the baseline devcontainer.json into your project.  
+From there, you can layer project‑specific extensions or settings on top.  
 
+🔧 Local Overrides with devcontainer.local.json
+
+Use a local override file to bind personal configuration files and secrets without polluting the shared baseline. For example, to mount your kube config, git settings, and SSH keys:
+
+```json
+"mounts": [
+  "source=${localEnv:HOME}/.kube,target=/home/vscode/.kube,type=bind",       // enables kube-related plugins and CLI
+  "source=${localEnv:HOME}/.gitconfig,target=/home/vscode/.gitconfig,type=bind", // enables git-related plugins and CLI
+  "source=${localEnv:HOME}/.ssh,target=/home/vscode/.ssh,type=bind"          // enables SSH-based plugins and CLI
+]
+```
+
+✅ Keeps sensitive paths out of version control
+
+✅ Ensures plugins and CLI tools can access your local configs
+
+✅ Fully replaces the mounts array from the baseline when defined locally
 
 ## 🧾 Included Components