[PATCH v2 1/2] CONTRIBUTING: refine steps for running CI tests prior to submission

["'Cedric Hombourger' via isar-users" <isar-users@googlegroups.com>]

Signed-off-by: Cedric Hombourger <cedric.hombourger@siemens.com>
---
 CONTRIBUTING.md | 36 +++++++++++++++++++++++++++++++++---
 1 file changed, 33 insertions(+), 3 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index f932417b..06f09aed 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -80,11 +80,16 @@ Plan merges to `master` so that both fit the two-week window; short extensions s
    * It's highly suggested to test your patchset before submitting it to the mailing
      by launching CI tests scripts. The procedure is described below:
 
+    ```
     git clone https://github.com/siemens/kas
     cat > kas.yml <<EOF
     header:
       version: 12
-      build_system: isar
+    build_system: isar
+    defaults:
+      repos:
+        patches:
+          repo: isar
     repos:
       isar:
         url: "http://github.com:/ilbers/isar"
@@ -94,6 +99,7 @@ Plan merges to `master` so that both fit the two-week window; short extensions s
           meta-isar:
     EOF
     kas/kas-container shell kas.yml
+    ```
 
     In kas shell:
 
@@ -102,13 +108,37 @@ Plan merges to `master` so that both fit the two-week window; short extensions s
         |sudo dd of=/etc/apt/trusted.gpg.d/debian-isar.gpg
     echo "deb [signed-by=/etc/apt/trusted.gpg.d/debian-isar.gpg] \
         http://deb.isar-build.org/debian-isar bookworm-isar main" \
-        |sudo /etc/apt/sources.list.d/10-isar_build.list
+        |sudo tee /etc/apt/sources.list.d/10-isar_build.list
     sudo apt-get update
-    sudo apt-get install avocado
+    sudo apt-get install -y avocado qemu-system-arm qemu-system-x86
     cd /work/isar/testsuite
     avocado run citest.py -t dev --max-parallel-tasks=1
     ```
 
+    Your git-formatpatches may be listed in the `kas.yml` file as illustrated below:
+
+    ```
+    ...
+    repos:
+      isar:
+        url: "http://github.com:/ilbers/isar"
+        refspec: master
+	patches:
+          0001:
+            path: /work/0001-my-contribution-to-isar.patch
+        layers:
+          meta:
+          meta-isar:
+    ```
+
+    Perform the above steps from a clean directory for your CI run to be as close as
+    possible to the environment that our project maintainers will be using. That
+    directory would contain: *.patch isar/ kas/ kas.yml
+
+    Be also mindful of community-provided resources such as deb.debian.org or
+    snapshot.debian.org and consider using a caching proxy in your setup to
+    reduce traffic as much as possible.
+
     Active developers may request from maintainers an account on isar-build.org
     to analyze CI logs or to launch their own CI builds there.
 
-- 
2.39.5

-- 
You received this message because you are subscribed to the Google Groups "isar-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to isar-users+unsubscribe@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/isar-users/20250321110100.3367400-2-cedric.hombourger%40siemens.com.