docs(srv): update

Author: SamyOubouaziz

macros/serverless-jobs/automate-resources-management.mdx

@@ -7,6 +7,10 @@ import Requirements from '@macros/iam/requirements.mdx'
 
 [Scaleway Serverless Jobs](/serverless-jobs/quickstart/) allows you to create and automate recurring tasks. This page shows how to create jobs to perform any operation available with the [Scaleway CLI](https://github.com/scaleway/scaleway-cli/blob/master/docs/commands/config.md) to automate the management of your Scaleway resources.
 
+<Message type="note">
+To automate complex commands, such as piped or `xargs` commands, refer to the [dedicated documentation](/serverless-jobs/how-to/execute-complex-commands/).
+</Message>
+
 Serverless Jobs are perfectly adapted for these autonomous tasks, as we do not need autoscaling or exposure via a web server. Refer to the [documentation on differences between jobs, containers, and functions](/serverless-jobs/reference-content/difference-jobs-functions-containers/) for more information.
 
 <Requirements />

pages/serverless-jobs/troubleshooting/job-startup-command-fails.mdx

@@ -0,0 +1,20 @@
+---
+title: My job run fails when executing the startup command
+description: Troubleshoot job run failures due to startup commands for your Scaleway Serverless Jobs.
+tags: serverless jobs troubleshooting issue error state message fail execution log faliure does not run command
+dates:
+  validation: 2025-08-20
+  posted: 2025-08-20
+---
+
+## Problem
+
+My job run fails due to its startup command.
+
+## Cause
+
+Complex commands, such as piped or `xargs` commands may lead to failures due to techical limitations of Serverless Jobs.
+
+## Possible solutions
+
+You can bypass this issue by using [Secret Manager](/secret-manager/) to pass complex commands in a shell script file via a [secret reference](/serverless-jobs/concepts/secrets-references). Refer to the [dedicated documentation](/serverless-jobs/how-to/execute-complex-commands/) for more information.