docs: updates

Author: LukasGentele

docs/hack/functions/main.go

@@ -367,7 +367,8 @@ var Functions = []Function{
 		Name:        "exec_container",
 		Description: `Executes the command provided as argument inside a container`,
 		Args:        `[command]`,
-		Handler:     basiccommands.Cat,
+		Flags:       commands.ExecContainerOptions{},
+		Handler:     commands.ExecContainer,
 		Group:       groupOther,
 	},
 	{

docs/pages/configuration/_partials/functions/exec_container.mdx

@@ -1,6 +1,12 @@
 
-
-<details className="config-field -function" data-expandable="false">
+import PartialImageselector from "./exec_container/image-selector.mdx"
+import PartialLabelselector from "./exec_container/label-selector.mdx"
+import PartialContainer from "./exec_container/container.mdx"
+import PartialNamespace from "./exec_container/namespace.mdx"
+import PartialDisablewait from "./exec_container/disable-wait.mdx"
+import PartialTimeout from "./exec_container/timeout.mdx"
+
+<details className="config-field -function" data-expandable="true">
 <summary>
 
 ### `exec_container` <span className="config-field-type">[command]</span> <span className="config-field-enum"></span> <span className="config-field-default -return"></span> <span className="config-field-required" data-required="true">pipeline only</span>  {#exec_container}
@@ -9,6 +15,12 @@ Executes the command provided as argument inside a container
 
 </summary>
 
+<PartialImageselector />
+<PartialLabelselector />
+<PartialContainer />
+<PartialNamespace />
+<PartialDisablewait />
+<PartialTimeout />
 
 
 </details>

docs/pages/configuration/_partials/functions/exec_container/container.mdx

@@ -0,0 +1,13 @@
+
+<details className="config-field -function" data-expandable="false">
+<summary>
+
+#### `--container` <span className="config-field-type">string</span> <span className="config-field-enum"></span> <span className="config-field-default -return"></span> <span className="config-field-required" data-required="false">pipeline only</span>  {#exec_container-container}
+
+The container to use
+
+</summary>
+
+
+
+</details>

docs/pages/configuration/_partials/functions/exec_container/disable-wait.mdx

@@ -0,0 +1,13 @@
+
+<details className="config-field -function" data-expandable="false">
+<summary>
+
+#### `--disable-wait` <span className="config-field-type">bool</span> <span className="config-field-enum"></span> <span className="config-field-default -return"></span> <span className="config-field-required" data-required="false">pipeline only</span>  {#exec_container-disable-wait}
+
+If true, will not wait for the container to become ready
+
+</summary>
+
+
+
+</details>

docs/pages/configuration/_partials/functions/exec_container/image-selector.mdx

@@ -0,0 +1,13 @@
+
+<details className="config-field -function" data-expandable="false">
+<summary>
+
+#### `--image-selector` <span className="config-field-type">string</span> <span className="config-field-enum"></span> <span className="config-field-default -return"></span> <span className="config-field-required" data-required="false">pipeline only</span>  {#exec_container-image-selector}
+
+The image selector to use to select the container
+
+</summary>
+
+
+
+</details>

docs/pages/configuration/_partials/functions/exec_container/label-selector.mdx

@@ -0,0 +1,13 @@
+
+<details className="config-field -function" data-expandable="false">
+<summary>
+
+#### `--label-selector` <span className="config-field-type">string</span> <span className="config-field-enum"></span> <span className="config-field-default -return"></span> <span className="config-field-required" data-required="false">pipeline only</span>  {#exec_container-label-selector}
+
+The label selector to use to select the container
+
+</summary>
+
+
+
+</details>

docs/pages/configuration/_partials/functions/exec_container/namespace.mdx

@@ -0,0 +1,13 @@
+
+<details className="config-field -function" data-expandable="false">
+<summary>
+
+#### `--namespace / -n` <span className="config-field-type">string</span> <span className="config-field-enum"></span> <span className="config-field-default -return"></span> <span className="config-field-required" data-required="false">pipeline only</span>  {#exec_container-namespace}
+
+The namespace to use
+
+</summary>
+
+
+
+</details>

docs/pages/configuration/_partials/functions/exec_container/timeout.mdx

@@ -0,0 +1,13 @@
+
+<details className="config-field -function" data-expandable="false">
+<summary>
+
+#### `--timeout` <span className="config-field-type">int64</span> <span className="config-field-enum"></span> <span className="config-field-default -return"></span> <span className="config-field-required" data-required="false">pipeline only</span>  {#exec_container-timeout}
+
+The timeout to wait. Defaults to 5 minutes
+
+</summary>
+
+
+
+</details>

docs/pages/configuration/functions/basics.mdx

@@ -11,15 +11,36 @@ import GlobalFunctionRef from '../_partials/functions/reference_global.mdx'
 Functions are bash functions that can be called inside the remainder of `devspace.yaml`. A common use case is to define reusable functionality that is called from within the scripts you specify within the `pipelines` section.
 
 There are two types of functions:
-1. [Custom Functions](#built-in-functions) defined in `devspace.yaml` (often added via [`imports`](../imports/basics.mdx))
-2. [Built-In Functions](#built-in-functions)
+1. [Custom Functions](#custom-functions) defined in `devspace.yaml` (often added via [`imports`](../imports/basics.mdx))
+2. [Built-In Functions](#built-in-functions) such as `build_images` or `create_deployments`
 
-## Workflow
 
-### 1. Define Functions
-<ConfigPartial/>
+## Custom Functions
+DevSpace provides support for custom functions. To use them, you need to:
+1. Declare your custom functions within the `functions` section of `devspace.yaml`
+2. Call custom functions from any scripted field in `devspace.yaml` such as in `pipelines` or in any value defined using an inline script such as `$(command)`
+
+### 1. Declare Functions
+Declaring a function means adding a key with the function name to the `functions` section in `devspace.yaml` as shown in the example below:
+```yaml
+functions:
+  hello_world: |-
+    echo "Hello World"
+  get_tag: |-
+    echo $(git rev-parse --short HEAD)
+```
 
 ### 2. Call Functions
+To call a custom function
+```yaml
+pipelines:
+  deploy: |-
+    build_images --tag $(get_git_commit)
+    create_deployments --all
+  dev: |-
+    hello_world
+    run_default_pipeline
+```
 
 
 ## Built-In Functions
@@ -37,3 +58,8 @@ Pipeline-only functions can only be used inside the scripts within the `pipeline
 Global functions can be used anywhere in `devspace.yaml`, either in config fields that expect a bash script such as within `functions` or using [`$(command)` vars](../variables/command.mdx) in any other config field.
 
 <GlobalFunctionRef/>
+
+
+## Config Reference
+
+<ConfigPartial/>

docs/src/css/content/code.scss

@@ -67,6 +67,22 @@
     padding-right: 2em;
   }
 
+  .prism-code {
+    .token {
+      &.key {
+        color: rgb(45, 178, 255);
+
+        ~ .punctuation  {
+          color: rgb(150, 150, 150) !important;
+        }
+      }
+
+      &.punctuation,
+      &.plain {
+        color: #fff !important;
+      }
+    }
+  }
 
   .markdown *:not(pre) > code,
   .contents code {