From dd742da309354db9ca6890705337915d6f02d44d Mon Sep 17 00:00:00 2001
From: Kenneth Hoste <kenneth.hoste@ugent.be>
Date: Mon, 20 Nov 2023 11:29:38 +0100
Subject: [PATCH] introduce role-focused landing pages

---
 docs/index.md              |  9 +++++----
 docs/roles/contributors.md | 15 +++++++++++++++
 docs/roles/developers.md   |  9 +++++++++
 docs/roles/end-users.md    | 11 +++++++++++
 docs/roles/maintainers.md  |  9 +++++++++
 docs/roles/user-support.md |  9 +++++++++
 6 files changed, 58 insertions(+), 4 deletions(-)
 create mode 100644 docs/roles/contributors.md
 create mode 100644 docs/roles/developers.md
 create mode 100644 docs/roles/end-users.md
 create mode 100644 docs/roles/maintainers.md
 create mode 100644 docs/roles/user-support.md

diff --git a/docs/index.md b/docs/index.md
index 5941ee398..7e72cb114 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -18,13 +18,14 @@ To contribute to this documentation, [open a pull request](https://github.com/ea
 
 **Quick links**
 
-- [What is EasyBuild?](what-is-easybuild.md) - [terminology](terminology.md)
+- [What is EasyBuild?](what-is-easybuild.md) | [Terminology](terminology.md)
 - [Installing](installation.md), [configuring](configuration.md), and [using](using-easybuild.md) EasyBuild
-- [Writing easyconfig files](writing-easyconfig-files.md) - [available easyconfig parameters](version-specific/easyconfig-parameters.md)
+- [Writing easyconfig files](writing-easyconfig-files.md) | [available easyconfig parameters](version-specific/easyconfig-parameters.md)
 - [Generic easyblocks](version-specific/generic-easyblocks.md)
 - List of [common toolchains](common-toolchains.md) and [supported software](version-specific/supported-software.md)
-- [Contributing to EasyBuild](contributing.md) - [GitHub integration features](integration-with-github.md)
-- [EasyBuild release notes](release-notes.md) - [EasyBuild v5.0](easybuild-v5/index.md)
+- [Contributing to EasyBuild](contributing.md) | [GitHub integration features](integration-with-github.md)
+- [EasyBuild release notes](release-notes.md) | [EasyBuild v5.0](easybuild-v5/index.md)
+- For [end users](roles/end-users) | [user support](roles/user-support) | [contributors](roles/contributors) | [developers](roles/developers) | [maintainers](roles/maintainers)
 - [Getting help](getting-help.md): [mailing list](https://lists.ugent.be/wws/info/easybuild) - [Slack](https://easybuild.io/join-slack) - [conference calls](https://github.com/easybuilders/easybuild/wiki/Conference-calls) - [GitHub](https://github.com/easybuilders)
 
 ---
diff --git a/docs/roles/contributors.md b/docs/roles/contributors.md
new file mode 100644
index 000000000..36188c807
--- /dev/null
+++ b/docs/roles/contributors.md
@@ -0,0 +1,15 @@
+# For contributors
+
+## EasyBuild 5.0
+
+Changes coming in EasyBuild 5.0 relevant to EasyBuild contributors.
+
+*(for a complete overview, see [here](../easybuild-v5/overview-of-changes.md))*
+
+### Framework & easyblocks
+
+* ...
+
+### Easyconfigs
+
+* ...
diff --git a/docs/roles/developers.md b/docs/roles/developers.md
new file mode 100644
index 000000000..523500791
--- /dev/null
+++ b/docs/roles/developers.md
@@ -0,0 +1,9 @@
+# For developers
+
+## EasyBuild 5.0
+
+Changes coming in EasyBuild 5.0 relevant to EasyBuild developers.
+
+*(for a complete overview, see [here](../easybuild-v5/overview-of-changes.md))*
+
+... 
diff --git a/docs/roles/end-users.md b/docs/roles/end-users.md
new file mode 100644
index 000000000..96b5cddc0
--- /dev/null
+++ b/docs/roles/end-users.md
@@ -0,0 +1,11 @@
+# For end users
+
+## EasyBuild 5.0
+
+Changes coming in EasyBuild 5.0 relevant to EasyBuild users.
+
+*(for a complete overview, see [here](../easybuild-v5/overview-of-changes.md))*
+
+... 
+
+* ...
diff --git a/docs/roles/maintainers.md b/docs/roles/maintainers.md
new file mode 100644
index 000000000..ce97db490
--- /dev/null
+++ b/docs/roles/maintainers.md
@@ -0,0 +1,9 @@
+# For maintainers
+
+## EasyBuild 5.0
+
+Changes coming in EasyBuild 5.0 relevant to EasyBuild maintainers.
+
+*(for a complete overview, see [here](../easybuild-v5/overview-of-changes.md))*
+
+* ...
diff --git a/docs/roles/user-support.md b/docs/roles/user-support.md
new file mode 100644
index 000000000..b4b4bfc76
--- /dev/null
+++ b/docs/roles/user-support.md
@@ -0,0 +1,9 @@
+# For user support teams
+
+## EasyBuild 5.0
+
+Changes coming in EasyBuild 5.0 relevant to user support teams.
+
+*(for a complete overview, see [here](../easybuild-v5/overview-of-changes.md))*
+
+* ...