migrations: replace vscode remote containers and docker compose dev environment from open dev containers

this changeset is to replace docker compose and vscode remote containers
with the new open dev containers.

- change .devcontainer.json schema to support open devcontainers
- use node lts docker image instead of vscode node image
- use dev container lifecycle events to install docsify and serve
content
- install docsify-cli globally
- reword and improve documentation content

BREAKING CHANGE: now that we have the new version of dev containers, the
vs code and docker compose versions are no longer supported.

Author: kosalaperera

.devcontainer/Dockerfile

@@ -1,54 +1,74 @@
 {
-    "name": "try-docsify",
-    "dockerComposeFile": "docker-compose.yml",
-    "service": "app",
-    "workspaceFolder": "/workspace",
-
-    // Set *default* container specific settings.json values on container create.
-    "settings": {
-        "terminal.integrated.shell.linux": "/bin/zsh",
+	"name": "try-docsify",
+	// See complete list https://hub.docker.com/_/node/tags?page=1&name=bullseye
+    "image": "node:lts-bullseye",
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	"forwardPorts": [
+        // Http
+        3000,
+        // Https
+        3001
+    ],
 
-        // Extensions
-        "eslint.workingDirectories": [
-            {
-                "directory": "./test-project",
-                "changeProcessCWD": true
-            }
-        ],
-        "liveServer.settings.NoBrowser": true,
-        "liveServer.settings.port": 5500
-    },
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	"remoteUser": "root",
 
-    // Add the IDs of extensions you want installed when the container is created.
-    "extensions": [
-        "ms-azuretools.vscode-docker",
+    // Add more features. See complete list https://github.com/devcontainers/features
+	"features": {
+		// Permission denied. More info: https://github.com/devcontainers/features/issues/440
+		"ghcr.io/devcontainers/features/common-utils:2": {
+			"configureZshAsDefaultShell": true
+		},
+		"ghcr.io/devcontainers/features/github-cli:1": {}
+	},
+    "containerEnv": {},
+    // Configure tool-specific properties.
+	"customizations": {
+		// Configure properties specific to VS Code.
+		"vscode": {
+			// Add the IDs of extensions you want installed when the container is created.
+			"extensions": [
+                "ms-azuretools.vscode-docker",
+                "ms-vscode-remote.remote-containers",
+                "redhat.vscode-yaml",
+                
+                "visualstudioexptteam.vscodeintellicode",
+                "dbaeumer.vscode-eslint",
+                "usernamehw.errorlens",
+                "christian-kohler.npm-intellisense",
+                "eg2.vscode-npm-script",
+                
+                "ritwickdey.live-sass",
+                
+                "editorconfig.editorconfig",
+                "esbenp.prettier-vscode",
+                
+                "bierner.github-markdown-preview",
+                "streetsidesoftware.code-spell-checker",
+                "znck.grammarly",
 
-        "dbaeumer.vscode-eslint",
-        "christian-kohler.npm-intellisense",
-        "eg2.vscode-npm-script",
-        "ritwickdey.liveserver",
-        "ritwickdey.live-sass",
+                "redhat.fabric8-analytics",
+                "ms-vscode.wordcount"              
+			],
+			// Set *default* container specific settings.json values on container create.
+			"settings": {
+				"terminal.integrated.defaultProfile.linux": "zsh",
 
-        "visualstudioexptteam.vscodeintellicode",
-        "ms-vscode.wordcount",
-        "editorconfig.editorconfig",
-        "esbenp.prettier-vscode",
-        "streetsidesoftware.code-spell-checker",
-        "znck.grammarly",
-        "redhat.fabric8-analytics",
-        "redhat.vscode-yaml",
-        "bierner.github-markdown-preview"
-    ],
+				"editor.formatOnPaste": true,
+				"editor.guides.bracketPairs": "active",
+				"debug.internalConsoleOptions": "neverOpen",
 
-    // Use 'forwardPorts' to make a list of ports inside the container available locally.
-    "forwardPorts": [
-        // Live server port
-        5500
-    ],
+                "scm.defaultViewMode": "tree",
 
-    // Use 'postCreateCommand' to run commands after the container is created.
-    "postCreateCommand": "zsh .devcontainer/post-create.zsh",
+				"files.watcherExclude": {
+					"**/node_modules/**": true
+				}
+            }
+		}
+	},
 
-    // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root.
-    "remoteUser": "node"
+	// Use 'updateContentCommand' to run commands after the container is successfully created.
+	"updateContentCommand": "yarn global add docsify-cli@latest --prefix /usr/local",
+	// Use 'postCreateCommand' to run commands after the container is created.
+	"postCreateCommand": "docsify serve . -p 3000"
 }

.devcontainer/devcontainer.json

@@ -0,0 +1,60 @@
+#
+# macOS ignores
+#
+
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+#
+# Windows ignores
+#
+
+# Windows thumbnail cache files
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+
+# Dump file
+*.stackdump
+
+# Folder config file
+[Dd]esktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk

.devcontainer/docker-compose.yml

@@ -2,7 +2,6 @@
 # Project Specific Ignores
 #
 
-
 #
 # VS Code Ignores
 #
@@ -16,9 +15,117 @@
 # Local History for Visual Studio Code
 .history/
 
+#
+# NodeJS Ignores
+#
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# TypeScript v1 declaration files
+typings/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+.env.test
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+
+# Next.js build output
+.next
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and *not* Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
 
 #
-# macOS Ignores
+# macOS ignores
 #
 
 # General
@@ -29,6 +136,7 @@
 # Icon must end with two \r
 Icon
 
+
 # Thumbnails
 ._*
 
@@ -48,9 +156,8 @@ Network Trash Folder
 Temporary Items
 .apdisk
 
-
 #
-# Windows Ignores
+# Windows ignores
 #
 
 # Windows thumbnail cache files
@@ -76,4 +183,4 @@ $RECYCLE.BIN/
 *.msp
 
 # Windows shortcuts
-*.lnk
+*.lnk