feat: add powershell deps/var/res docs (windmill-labs#439)

hugocasa · web-flow · commit 5a883c480477 · 2023-12-13T16:37:41.000+01:00
diff --git a/docs/advanced/6_imports/index.md b/docs/advanced/6_imports/index.md
@@ -125,9 +125,20 @@ script and hence there is no need for any additional steps.
 
 e.g:
 
-```
+```go
 import (
 	"rsc.io/quote"
     wmill "github.com/windmill-labs/windmill-go-client"
 )
 ```
+
+## Imports in PowerShell
+
+For PowerShell, imports are parsed when the script is run and modules are automatically installed if they are not found in the cache.
+
+e.g.: 
+
+```powershell
+Import-Module -Name MyModule
+```
+
diff --git a/docs/core_concepts/2_variables_and_secrets/index.mdx b/docs/core_concepts/2_variables_and_secrets/index.mdx
@@ -186,4 +186,13 @@ curl -s -H "Authorization: Bearer $WM_TOKEN" \
     | jq -r .value
 ```
 
-The last example is in bash and showcase well how it works under the hood: It fetches the secret from the API using the job's permissions through the ephemeral token passed as environment variable to the job.
+PowerShell:
+
+```powershell
+$Headers = @{
+  "Authorization" = "Bearer $Env:WM_TOKEN"
+}
+Invoke-RestMethod -Headers $Headers -Uri "$Env:BASE_INTERNAL_URL/api/w/$Env:WM_WORKSPACE/variables/get/u/user/foo"
+```
+
+The last examples in bash and PowerShell showcase well how it works under the hood: It fetches the secret from the API using the job's permissions through the ephemeral token passed as an environment variable to the job.
diff --git a/docs/core_concepts/3_resources_and_types/index.mdx b/docs/core_concepts/3_resources_and_types/index.mdx
@@ -208,4 +208,13 @@ curl -s -H "Authorization: Bearer $WM_TOKEN" \
     | jq -r .value
 ```
 
+PowerShell:
+
+```powershell
+$Headers = @{
+  "Authorization" = "Bearer $Env:WM_TOKEN"
+}
+Invoke-RestMethod -Headers $Headers -Uri "$Env:BASE_INTERNAL_URL/api/w/$Env:WM_WORKSPACE/resources/get/u/user/foo"
+```
+
 ![Fetch resource](./fetch_resource.png.webp)
diff --git a/docs/getting_started/0_scripts_quickstart/4_bash_quickstart/index.mdx b/docs/getting_started/0_scripts_quickstart/4_bash_quickstart/index.mdx
@@ -65,7 +65,7 @@ fi
 </TabItem>
 <TabItem value="powershell" label="PowerShell" attributes={{className: "text-xs p-4 !mt-0 !ml-0"}}>
 
-```ts
+```powershell
 param($url = "default value")
 
 $status_code = (Invoke-WebRequest -Uri $url -Method Get).StatusCode
@@ -158,24 +158,26 @@ echo "Hello $msg"
 
 In Bash, the arguments are inferred from the arguments requiring a $1, $2, $3. Default arguments can be specified using the syntax above: `dflt="${2:-default value}"`.
 
-The command `echo` allows you to return the result, which might be useful if the script is used in a [flow](../../../flows/1_flow_editor.mdx) or [app](../../../apps/0_app_editor/index.mdx) to pass its result on.
+The last line of the output, here `echo "Hello $msg"`, is the return value, which might be useful if the script is used in a [flow](../../../flows/1_flow_editor.mdx) or [app](../../../apps/0_app_editor/index.mdx) to pass its result on.
 
 ### PowerShell
 
-As we picked `PowerShell` for this example, Windmill provided some Bash
+As we picked `PowerShell` for this example, Windmill provided some PowerShell
 boilerplate. Let's take a look:
 
-```bash
+```powershell
 param($Msg, $Dflt = "default value", [int]$Nb = 3)
 
+# Import-Module MyModule
+
 # the last line of the stdout is the return value
 Write-Output "Hello $Msg"
 ```
 
-In PowerShell, the arguments are inferred from the arguments requiring a "$" preceding its name.
+In PowerShell, the arguments are inferred from the param instruction. It has to be first in the script.
 Default arguments can be specified using the syntax above: `$argument_name = "Its default value"`.
 
-The command `Write-Output` allows you to return the result, which might be useful if the script is used in a [flow](../../../flows/1_flow_editor.mdx) or [app](../../../apps/0_app_editor/index.mdx) to pass its result on.
+The last line of the output, here `Write-Output "Hello $Msg"`, is the return value, which might be useful if the script is used in a [flow](../../../flows/1_flow_editor.mdx) or [app](../../../apps/0_app_editor/index.mdx) to pass its result on.
 
 ## Instant Preview & Testing
 
diff --git a/docusaurus.config.js b/docusaurus.config.js
@@ -157,7 +157,8 @@ const config = {
 			},
 			prism: {
 				theme: lightCodeTheme,
-				darkTheme: darkCodeTheme
+				darkTheme: darkCodeTheme,
+				additionalLanguages: ['powershell']
 			},
 			colorMode: {
 				defaultMode: 'dark',
