From 5d576d8b3c40646bc9f580fa375526876c3a29af Mon Sep 17 00:00:00 2001
From: Mai-Lapyst <mai-lapyst@noreply.codeberg.org>
Date: Fri, 23 Aug 2024 17:59:53 +0200
Subject: [PATCH] Document better how the `shell` prop in steps work

---
 docs/user/actions.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/user/actions.md b/docs/user/actions.md
index c7075e3b..ea7e8d6a 100644
--- a/docs/user/actions.md
+++ b/docs/user/actions.md
@@ -955,6 +955,16 @@ jobs:
       - run: echo using sh here
 ```
 
+Available values:
+
+- `bash`
+- `pwsh`
+- `python`
+- `sh`
+- `cmd`
+- `powershell`
+- A custom commandline, where `{0}` is replaced with the path to a (temporary) file, containing the content of `jobs.<job_id>.steps[*].run`.
+
 [Check out the example](https://code.forgejo.org/forgejo/end-to-end/src/branch/main/actions/example-pull-request/.forgejo/workflows/test.yml)
 
 ### `jobs.<job_id>.steps[*].id`