Feat/Docs Evolution to v2 with a FastTrack Path

---------
Co-authored-by: Julien Strebler <[email protected]>
Co-authored-by: Damien Aicheh <[email protected]>

Author: Justrebl

.devcontainer/devcontainer.json

@@ -41,11 +41,15 @@
         "ms-vscode.vscode-node-azure-pack", 
         // Azurite : Storage Account Emulator for local Azure Function Debug
         "azurite.azurite",
-        //Language related extensions
+        // Language related extensions
         "ms-dotnettools.csharp", 
         "ms-python.python",
+        // Mardown helpers : 
+        "davidanson.vscode-markdownlint", 
+        "valentjn.vscode-ltex",
         // Terraform
         "hashicorp.terraform"    
+
       ]
     }
   },

.gitignore

@@ -1 +1,7 @@
-*.zip
+*.zip
+
+# Local Dev Tools : Azurite
+__blobstorage__*
+__queuestorage__*
+__azurite_*
+*.bkp

.vscode/hands-on-lab-serverless.code-workspace

@@ -1,7 +1,36 @@
 {
-    "folders": [
-        {
-            "path": ".."
-        }
-    ]
+	"folders": [
+		{
+			"path": "..",
+		},
+		{
+			"path": "../src/webapp",
+			"name": "Lab 0 - Azure Static Web App "
+		},
+		{
+			"path": "../src/solutions/dotnet",
+			"name": "Lab 1 - Dotnet - Az Function (Solution)"
+		},
+		{
+			"path": "../src/solutions/nodejs",
+			"name": "Lab 1 - NodeJs - Az Function (Solution)"
+		},
+		{
+			"path": "../src/solutions/python",
+			"name": "Lab 1 - Python - Az Function (Solution)"
+		},
+		{
+			"path": "../docs",
+			"name": "Documentation"
+		}
+	],
+	"settings": {
+		"debug.internalConsoleOptions": "neverOpen",
+		"azurite.location": "/tmp",
+		"ltex.checkFrequency": "save",
+		"ltex.additionalRules.motherTongue": "en-US",
+		"ltex.dictionary": {
+			"en-US":[":../docs/ltex.dictionary.en-US.txt"]
+		}
+	}
 }

README.md

@@ -4,14 +4,13 @@ This Hands On Lab will let you discover and practice the Azure serverless servic
 
 ## Prerequisites
 
-To start this Hands On Lab you will need :
+You will find all the prerequisites at :  [ [MOAW] Product Hands-on Lab : Azure Serverless Architecture > Prerequisites][moaw-prereq-link]
 
-- An Azure Subscription with the `Contributor` role to create and manage the labs' resources
-- A dedicated resource group for this lab to ease the cleanup at the end.
-- The [Azure CLI][az-cli-install] installed on your machine
-- The [Azure Functions Core Tools][az-func-core-tools] installed, this will be useful for creating the scaffold of your Azure Functions using command line.
-- If you are using VS Code, you can also install the [Azure Function extension][azure-function-vs-code-extension]
-- Register the Azure providers on your Azure Subscription if not done yet: `Microsoft.CognitiveServices`, `Microsoft.DocumentDB`, `Microsoft.EventGrid`, `Microsoft.KeyVault`, `Microsoft.Logic`, `Microsoft.SignalRService`, `Microsoft.Web`
+Different Development Environment Options will also be offered :
+
+- Locally with the tools required
+- Devcontainer on your machine 
+- Codespace directly from your browser
 
 ## Contributing
 
@@ -34,3 +33,5 @@ trademarks or logos is subject to and must follow
 [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
 Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
 Any use of third-party trademarks or logos are subject to those third-party's policies.
+
+[moaw-prereq-link]: https://moaw.dev/workshop/gh:microsoft/hands-on-lab-serverless/main/docs/#prerequisites

docs/.markdownlint.json

@@ -0,0 +1,3 @@
+{
+    "MD033":false
+}

docs/assets/architecture-lab2.svg

@@ -0,0 +1,2 @@
+PubSub
+PUBSUB

docs/assets/codespace-configure.png

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Attach to .NET Functions",
+      "type": "coreclr",
+      "request": "attach",
+      "processId": "${command:azureFunctions.pickProcess}"
+    }
+  ]
+}

docs/assets/codespace-new.png

@@ -0,0 +1,7 @@
+{
+    "azureFunctions.projectSubpath": ".",
+    "azureFunctions.deploySubpath": "bin/Release/net7.0/publish",
+    "azureFunctions.projectLanguage": "C#",
+    "azureFunctions.projectRuntime": "~4",
+    "azureFunctions.preDeployTask": "publish (functions)"
+}

docs/assets/codespace-terminal-new.png

@@ -0,0 +1,81 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "clean (functions)",
+      "command": "dotnet",
+      "args": [
+        "clean",
+        "/property:GenerateFullPaths=true",
+        "/consoleloggerparameters:NoSummary"
+      ],
+      "type": "process",
+      "problemMatcher": "$msCompile",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      }
+    },
+    {
+      "label": "build (functions)",
+      "command": "dotnet",
+      "args": [
+        "build",
+        "/property:GenerateFullPaths=true",
+        "/consoleloggerparameters:NoSummary"
+      ],
+      "type": "process",
+      "dependsOn": "clean (functions)",
+      "group": {
+        "kind": "build",
+        "isDefault": true
+      },
+      "problemMatcher": "$msCompile",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      }
+    },
+    {
+      "label": "clean release (functions)",
+      "command": "dotnet",
+      "args": [
+        "clean",
+        "--configuration",
+        "Release",
+        "/property:GenerateFullPaths=true",
+        "/consoleloggerparameters:NoSummary"
+      ],
+      "type": "process",
+      "problemMatcher": "$msCompile",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      }
+    },
+    {
+      "label": "publish (functions)",
+      "command": "dotnet",
+      "args": [
+        "publish",
+        "--configuration",
+        "Release",
+        "/property:GenerateFullPaths=true",
+        "/consoleloggerparameters:NoSummary"
+      ],
+      "type": "process",
+      "dependsOn": "clean release (functions)",
+      "problemMatcher": "$msCompile",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      }
+    },
+    {
+      "type": "func",
+      "dependsOn": "build (functions)",
+      "options": {
+        "cwd": "${workspaceFolder}/bin/Debug/net7.0"
+      },
+      "command": "host start",
+      "isBackground": true,
+      "problemMatcher": "$func-dotnet-watch"
+    }
+  ]
+}

docs/assets/codespace-workspace-select.png

@@ -22,6 +22,7 @@ public CosmosToWebPubSub(ILoggerFactory loggerFactory)
                 databaseName: "%COSMOS_DB_DATABASE_NAME%",
                 collectionName: "%COSMOS_DB_CONTAINER_ID%",
                 ConnectionStringSetting = "COSMOS_DB_CONNECTION_STRING_SETTING",
+                CreateLeaseCollectionIfNotExists = true,
                 LeaseCollectionName = "leases")
             ] IReadOnlyList<Transcription> input
         )