From f9114faf304022cfa3b687c7e7f3034b3468e554 Mon Sep 17 00:00:00 2001
From: jalvesz <jose.alves@transvalor.com>
Date: Wed, 23 Apr 2025 21:55:15 +0200
Subject: [PATCH 1/2] add collab script and documentation in the workflow

---
 .github/collab.sh | 31 +++++++++++++++++++++++++++++++
 WORKFLOW.md       | 37 +++++++++++++++++++++++++++++++++++++
 2 files changed, 68 insertions(+)
 create mode 100644 .github/collab.sh

diff --git a/.github/collab.sh b/.github/collab.sh
new file mode 100644
index 000000000..84aaa9a93
--- /dev/null
+++ b/.github/collab.sh
@@ -0,0 +1,31 @@
+#!/bin/bash
+
+echo "📦 GitHub Fork Collaboration Setup Script"
+
+# Prompt for User's GitHub username
+
+read -p "Enter the GitHub username of the fork owner (e.g., alice): " USER
+
+# Prompt for the branch name
+
+read -p "Enter the PR branch name (e.g., feature-branch): " BRANCH
+
+# Add remotes
+
+echo "🔗 Adding remotes..."
+
+git remote add $USER https://github.com/$USER/stdlib.git
+
+# Fetch and checkout the PR branch
+
+echo "📥 Fetching branch '$BRANCH'..."
+
+git fetch $USER
+
+git checkout -b $BRANCH $USER/$BRANCH
+
+# Done
+
+echo "✅ Repo set up. You're now on '$BRANCH'."
+
+echo "You can now make changes and push directly to $USER/stdlib:$BRANCH"
\ No newline at end of file
diff --git a/WORKFLOW.md b/WORKFLOW.md
index e85fbf077..d836f1b65 100644
--- a/WORKFLOW.md
+++ b/WORKFLOW.md
@@ -109,3 +109,40 @@ The project is usable as CMake subproject. Explicit references to
 break subproject builds.
 An example project is available [here](https://github.com/fortran-lang/stdlib-cmake-example)
 to test the CMake subproject integration.
+
+## GitHub collaboration
+
+Contributing can be daunting, we know! Even more for a big project with many contributors, and if you are not expert on the whole github workflow then even more, we have been there at some point.
+
+In order to help lowering the barrier for collaborating on ongoing efforts (e.g. an open PR), we have crafted a simple script that might come in handy. To explain the process we'll use Alice (the person you want to help) and Bob (you):
+
+       ┌────────────────────────────┐
+       │    fortran-lang/stdlib     │
+       └────────────▲───────────────┘
+                    │
+                    │  [Pull Request]
+                    │
+            ┌───────┴────────┐
+            │  alice/stdlib  │ ←─────┐
+            └──────▲─────────┘       │
+                   │                 │
+   [PR Branch] ←───┘          ┌──────┴──────┐
+   feature-branch             │  bob/stdlib │
+   (hosted here)              │    (fork)   │
+                              └─────────────┘
+                                     ▲
+                                     │
+                       [Push access to Alice's repo]
+
+After having forked and downloaded locally `stdlib` on your local machine; on an unix compatible terminal with access to the `git` CLI, being at the root folder: 
+```sh
+./.github/collab.sh
+```
+You will be asked to enter the username and branch of the other person:
+```bash
+Enter the GitHub username of the fork owner (e.g., alice): alice
+Enter the PR branch name (e.g., feature-branch): feature-branch
+```
+This will fetch Alice's repository and switch your view to Alice's feature-branch. Now you can review, build, run, play around, propose your nice improvements.
+
+Remember, to announce your willingness to help 😉

From 13f408da622741113d9d7a98d328c2666ffa1c19 Mon Sep 17 00:00:00 2001
From: jalvesz <jose.alves@transvalor.com>
Date: Wed, 23 Apr 2025 22:17:03 +0200
Subject: [PATCH 2/2] typo

---
 WORKFLOW.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/WORKFLOW.md b/WORKFLOW.md
index d836f1b65..b0bc9a791 100644
--- a/WORKFLOW.md
+++ b/WORKFLOW.md
@@ -145,4 +145,4 @@ Enter the PR branch name (e.g., feature-branch): feature-branch
 ```
 This will fetch Alice's repository and switch your view to Alice's feature-branch. Now you can review, build, run, play around, propose your nice improvements.
 
-Remember, to announce your willingness to help 😉
+Remember, announce your willingness to help 😉