documentation an some refactoring, release alpha

.devcontainer/devops-dev/devcontainer.json

@@ -1,12 +1,22 @@
-// For format details, see https://aka.ms/devcontainer.json. For config options, see the
-// README at: https://github.com/devcontainers/templates/tree/main/src/ubuntu
+// ⚠️ Temporary / Testing Only ⚠️
+// -----------------------------------------------------------------------------
+// This devcontainer.json is provided solely for local testing and experimentation.
+// It is NOT the canonical configuration for DevOps projects.
+// 
+// ✅ The single source of truth lives in:
+//    - README.md (usage instructions)
+//    - /devops/templates/devcontainer.json (baseline template)
+// 
+// Always consult those files before making changes. This file may diverge,
+// and should never be treated as the authoritative definition.
+// -----------------------------------------------------------------------------
 {
 	"build": {
-		"dockerfile": "Dockerfile",        
-		"context": "."                   
+		"dockerfile": "../../devops/Dockerfile",        
+		"context": "../../devops"                   
 	},
 	"remoteUser": "vscode",
-	"name": "devops",
+	"name": "devops-devs",
 	"runArgs": [
 		"--hostname=devops"
 	],
@@ -20,7 +30,10 @@
 				"yzhang.markdown-all-in-one",
 				"davidanson.vscode-markdownlint",
 				"eamodio.gitlens",
-				"m4ns0ur.base64"
+				"m4ns0ur.base64",
+				"rogalmic.bash-debug",
+				"streetsidesoftware.code-spell-checker",
+				"ms-azuretools.vscode-containers"
 			]
 		}
 	}